# Install ctpv with Homebrew, MacPorts, Nix Image previews for lf file manager. Version 1.1 via Homebrew; verified 2026-06-15. ## Install ```sh sudo av install brew:ctpv ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install ctpv ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install ctpv ``` Evidence: MacPorts ports tree: graphics/ctpv/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Nix (92%): ```sh nix profile install nixpkgs#ctpv ``` Evidence: nixpkgs package indexes: pkgs/by-name/ct/ctpv/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:ctpv - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.1 - **Source summary:** Image previews for lf file manager - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-06-15T10:20:14-04:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - ctpv (cli) - ctpvclear (cli) - ctpvquit (cli) - ctpv (alias) - ctpvclear (alias) - ctpvquit (alias) ## Dependencies - libmagic - openssl@4 ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.1 - Package-manager updated: 2026-06-15 - Local data: ok - Upstream repository: https://github.com/NikitaIvanovV/ctpv - Upstream latest detected: v1.1 (current) ## Project history and usage ctpv is a terminal file previewer written with lf file-manager integration in mind. It previews text, archives, PDFs, images, videos, and other file types by selecting from installed helper programs. ### Project history The README describes ctpv as a C remake of stpv. The author liked stpv's behavior but found its POSIX-shell implementation sluggish, so ctpv was written in C as a faster version with additional features. Official GitHub releases show v1.0 in July 2022 and v1.1 in March 2023. The project documentation now includes both README integration examples and a generated CTPV(1) manual page. ### Adoption history The README documents package-manager paths for AUR, MacPorts, Homebrew, Nix, and Gentoo overlay users, along with source builds. Its NixOS/Home Manager example shows ctpv being packaged as part of declarative terminal-file-manager configuration. ### How it is used ctpv is usually configured as lf's previewer and cleaner, with ctpv, ctpvclear, and ctpvquit coordinating preview output and lifecycle. Image previews can use Ueberzug, Chafa, or Kitty terminal support, while other previews delegate to common tools such as bat, jq, poppler, ffmpegthumbnailer, and atool. ### Why package nerds care ctpv is package-manager-friendly because most of its functionality is integration glue over existing Unix tools. A package can ship the core C binary and manpage, while optional preview capabilities naturally expand as the user's system has more helper programs installed. ### Timeline - 2022: v1.0 release published. - 2023: v1.1 release published. - 2023: Documentation noted Wayland/sixel guidance for lf image previews. ### Related projects - ctpv is related to lf, stpv, Ueberzug, Chafa, Kitty, and the many small Unix preview helpers it can dispatch. ### Sources - - - ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## 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: $XDG_CONFIG_HOME/ctpv/config, ~/.config/ctpv/config ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** ctpv - **Version Scheme:** 0 - **Revision:** 1 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Nix - ctpv: normalized package name match | nixpkgs package indexes: pkgs/by-name/ct/ctpv/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - MacPorts - ctpv: normalized package name match | MacPorts ports tree: graphics/ctpv/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [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. - [Media and graphics packages](https://www.automicvault.com/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata. - [openssl@4](https://www.automicvault.com/pkg/brew/openssl-4/) - Runtime dependency declared by Homebrew. - [far2l-tty](https://www.automicvault.com/pkg/brew/far2l-tty/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [fdclone](https://www.automicvault.com/pkg/brew/fdclone/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [lf](https://www.automicvault.com/pkg/brew/lf/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [midnight-commander](https://www.automicvault.com/pkg/brew/midnight-commander/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [nnn](https://www.automicvault.com/pkg/brew/nnn/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [projectable](https://www.automicvault.com/pkg/brew/projectable/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [superfile](https://www.automicvault.com/pkg/brew/superfile/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. - [vim](https://www.automicvault.com/pkg/brew/vim/) - Shares av.db curated category or tags: cli, file-management, file-manager, productivity, terminal. ## Combined YAML source View the package source record on GitHub. [combined/ctpv.yml](https://github.com/automic-vault/db/blob/main/combined/ctpv.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