# Install nvimpager with Homebrew, apk, MacPorts, Nix, zypper Use NeoVim as a pager to view manpages, diffs, etc. Version 0.14.0 via Homebrew; verified 2026-05-18. ## Install ```sh sudo av install brew:nvimpager ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install nvimpager ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install nvimpager ``` Evidence: MacPorts ports tree: sysutils/nvimpager/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add nvimpager ``` Evidence: Alpine Linux edge package indexes: nvimpager from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz - Nix (92%): ```sh nix profile install nixpkgs#nvimpager ``` Evidence: nixpkgs package indexes: pkgs/by-name/nv/nvimpager/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - zypper (92%): ```sh sudo zypper install nvimpager ``` Evidence: openSUSE Tumbleweed package metadata: nvimpager from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:nvimpager - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.14.0 - **Source summary:** Use NeoVim as a pager to view manpages, diffs, etc. - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** BSD-2-Clause - **Source archive:** - **Last updated:** 2026-05-18T12:31:01-04:00 - **Generated:** 2026-07-08T18:08:21+00:00 ## Executables - nvimpager (cli) - nvimpager (alias) ## Dependencies - neovim ## Build dependencies - scdoc ## Install behavior - Post-install hook: not defined - Caveats: To use nvimpager as your default pager, add `export PAGER=nvimpager` to your shell configuration. - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.14.0 - Package-manager updated: 2026-05-18 - Local data: ok - Upstream repository: https://github.com/lucc/nvimpager - Upstream latest detected: v0.14.0 (current) ## Project history and usage nvimpager is a small pager wrapper that launches Neovim in a pager-like mode for man pages, files, pipes, and diffs. It is not trying to replace `less` for every workload; it exists for users who want Neovim syntax highlighting, mouse behavior, and familiar keybindings while reading output. ### Project history The nvimpager repository was created on 2017-10-23. Its README describes the project as a rewrite of vimpager with fewer but stricter dependencies and with Neovim as the target editor. The project stayed deliberately small: a wrapper script, a man page, a separate configuration path under `~/.config/nvimpager`, and enough logic to choose pager mode or cat mode depending on input. ### Adoption history nvimpager's adoption follows the shell-customization path: people find it through Neovim, then set `PAGER=nvimpager` or use it for `man`, `git diff`, and piped command output. Homebrew packages version 0.14.0 and declares Neovim as a runtime dependency. The package is also present in several Unix packaging ecosystems, including Homebrew, MacPorts, Nix, Alpine, and openSUSE, which is the right scale for a focused terminal utility. ### How it is used The README shows the practical workflow: run `nvimpager file`, pipe text into it, or export `PAGER=nvimpager` and then use `man bash` or `git diff`. Cat mode prints highlighted output directly when opening the full Neovim interface would be overkill. Users configure nvimpager separately from their normal Neovim setup with `~/.config/nvimpager/init.vim` or `~/.config/nvimpager/init.lua`, which keeps pager behavior from being accidentally slowed or broken by a full editing config. ### Why package nerds care nvimpager matters because it turns an editor into a Unix pipeline component without pretending every terminal read needs a new pager implementation. It is a thin adapter around a powerful installed tool. Its limitations are part of the package story: the README notes that large files and lazy pipe reading remain areas where `less` is faster or more memory efficient. ### Timeline - 2017-10-23: GitHub repository created. - 2026-04-17: repository push date reported by GitHub API before Homebrew's 0.14.0 packaging. - 2026 Homebrew metadata: stable version 0.14.0 listed with Neovim dependency. ### Related projects - Neovim is the editor runtime nvimpager wraps. - vimpager is the earlier Vim-oriented pager project named by the nvimpager README. - `less` remains the conventional pager nvimpager complements rather than fully replaces. ### Sources - - - - - ## 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: ~/.config/nvimpager/init.vim, ~/.config/nvimpager/init.lua ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** nvimpager - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - nvimpager: normalized package name match | nixpkgs package indexes: pkgs/by-name/nv/nvimpager/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - nvimpager - 0.12.0-r0: normalized package name match | Alpine Linux edge package indexes: nvimpager from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Use nvim as a pager to view manpages, diffs, etc with nvim's syntax highlighting | https://github.com/lucc/nvimpager - apk - nvimpager-doc - 0.12.0-r0: normalized package name match | Alpine Linux edge package indexes: nvimpager-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Use nvim as a pager to view manpages, diffs, etc with nvim's syntax highlighting (documentation) | https://github.com/lucc/nvimpager - apk - nvimpager-zsh-completion - 0.12.0-r0: normalized package name match | Alpine Linux edge package indexes: nvimpager-zsh-completion from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Zsh completions for nvimpager | https://github.com/lucc/nvimpager - zypper - nvimpager - 0.14.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: nvimpager from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Use nvim as a pager | https://github.com/lucc/nvimpager - zypper - nvimpager-zsh-completion - 0.14.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: nvimpager-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Zsh completion for nvimpager | https://github.com/lucc/nvimpager - MacPorts - nvimpager: normalized package name match | MacPorts ports tree: sysutils/nvimpager/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. - [neovim](https://www.automicvault.com/pkg/brew/neovim/) - Runtime dependency declared by Homebrew. - [scdoc](https://www.automicvault.com/pkg/brew/scdoc/) - Build dependency declared by Homebrew. - [page](https://www.automicvault.com/pkg/brew/page/) - Shares av.db curated category or tags: cli, neovim, pager, productivity, terminal. - [eless](https://www.automicvault.com/pkg/brew/eless/) - Shares av.db curated category or tags: cli, pager, productivity, terminal. - [vimpager](https://www.automicvault.com/pkg/brew/vimpager/) - 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. - [urlscan](https://www.automicvault.com/pkg/brew/urlscan/) - Local package facts share a topical domain. Shared terms: cli, productivity, terminal, view. ## Combined YAML source View the package source record on GitHub. [combined/nvimpager.yml](https://github.com/automic-vault/db/blob/main/combined/nvimpager.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