# Install vimpager with Homebrew, MacPorts, Nix, pacman

Use ViM as PAGER. Version 2.06 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:vimpager
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install vimpager
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install vimpager
```

  Evidence: MacPorts ports tree: sysutils/vimpager/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#vimpager
```

  Evidence: nixpkgs package indexes: vimpager from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix

- pacman (92%):

```sh
sudo pacman -S vimpager
```

  Evidence: Arch Linux sync databases: vimpager from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

## Package facts

- **Package key:** brew:vimpager
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/vimpager>
- **Version:** 2.06
- **Source summary:** Use ViM as PAGER
- **Homepage:** <https://github.com/rkitover/vimpager>
- **Repository:** <https://github.com/rkitover/vimpager>
- **Upstream docs:** <https://github.com/rkitover/vimpager#readme>
- **License:** BSD-2-Clause
- **Source archive:** <https://github.com/rkitover/vimpager/archive/refs/tags/2.06.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- vimcat (cli)
- vimpager (cli)
- vimcat (alias)
- vimpager (alias)

## Build dependencies

- pandoc

## Install behavior

- Post-install hook: not defined
- Caveats: To use vimpager as your default pager, add `export PAGER=vimpager` to your shell configuration.
- Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.06
- Local data: ok
- Upstream repository: https://github.com/rkitover/vimpager
- Upstream latest detected: 2.06 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

vimpager is a small Unix-style pager wrapper that uses Vim as the interactive pager. Its README and vim.org script page describe it as a pager using less.vim with support for highlighted man pages and other features on Unix-like systems, Cygwin, and MSYS.

### Project history

The project is maintained by Rafael Kitover and distributed both through its GitHub repository and the historical vim.org scripts catalog as script 1723. The vimpager script identifies itself as a shell script for using Vim as PAGER and notes that it is based on Bram Moolenaar's less.sh.

### Adoption history

vimpager belongs to the long-running pattern of making terminal tools use a preferred editor's navigation model. Its vim.org script listing shows substantial historical script-catalog usage, and its packaging in systems such as Homebrew, MacPorts, Nix, and pacman reflects its role as a niche but recognizable tool for Vim-oriented shell users.

### How it is used

Users set PAGER or aliases such as less to vimpager so command output, manual pages, and logs open inside a read-only Vim-driven pager. vimpager also ships vimcat, which uses Vim as a syntax-highlighting backend for cat-like output while falling back safely when output is not a terminal.

### Why package nerds care

For package nerds, vimpager is a classic composability package: it turns the shell's generic PAGER convention into a Vim interface, preserving syntax highlighting, search, movement, and familiar Vim customization in places normally handled by less.

### Related projects

- vimpager is related to Vim's less.vim, the historical less.sh script, vimcat, and other Vim-as-pager plugins such as vim-pager.

### Sources

- <https://github.com/rkitover/vimpager>
- <https://github.com/rkitover/vimpager/blob/master/markdown/vimcat.md>
- <https://github.com/rkitover/vimpager/blob/master/vimpager>
- <https://www.vim.org/scripts/script.php?script_id=1723>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.vimpagerrc, ~/.vim/vimpagerrc
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** vimpager
- **Aliases:** vimcat
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - vimpager: normalized package name match | nixpkgs package indexes: vimpager from https://raw.githubusercontent.com/NixOS/nixpkgs/master/pkgs/top-level/all-packages.nix
- pacman - vimpager - 2.06-7: normalized package name match | Arch Linux sync databases: vimpager from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A vim-based script to use as a PAGER. | https://www.vim.org/scripts/script.php?script_id=1723
- MacPorts - vimpager: normalized package name match | MacPorts ports tree: sysutils/vimpager/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Productivity CLI packages](https://www.automicvault.com/pkg/productivity-cli-packages/) - Matched curated productivity category metadata from av.db.
- [pandoc](https://www.automicvault.com/pkg/brew/pandoc/) - Build dependency declared by Homebrew.
- [eless](https://www.automicvault.com/pkg/brew/eless/) - Shares av.db curated category or tags: cli, pager, productivity, terminal.
- [nvimpager](https://www.automicvault.com/pkg/brew/nvimpager/) - Shares av.db curated category or tags: cli, pager, productivity, terminal.
- [page](https://www.automicvault.com/pkg/brew/page/) - Shares av.db curated category or tags: cli, pager, productivity, terminal.
- [byobu](https://www.automicvault.com/pkg/brew/byobu/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [cbonsai](https://www.automicvault.com/pkg/brew/cbonsai/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [sc-im](https://www.automicvault.com/pkg/brew/sc-im/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [sheets](https://www.automicvault.com/pkg/brew/sheets/) - Shares av.db curated category or tags: cli, productivity, terminal.
- [smug](https://www.automicvault.com/pkg/brew/smug/) - Shares av.db curated category or tags: cli, productivity, terminal.

## Combined YAML source

View the package source record on GitHub. [combined/vimpager.yml](https://github.com/automic-vault/db/blob/main/combined/vimpager.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
