# Install tpix with Homebrew

Simple terminal image viewer using the Kitty graphics protocol. Version 1.0.3 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:tpix
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install tpix
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:tpix
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/tpix>
- **Version:** 1.0.3
- **Source summary:** Simple terminal image viewer using the Kitty graphics protocol
- **Homepage:** <https://github.com/jesvedberg/tpix>
- **Repository:** <https://github.com/jesvedberg/tpix>
- **Upstream docs:** <https://github.com/jesvedberg/tpix#readme>
- **License:** MIT
- **Source archive:** <https://github.com/jesvedberg/tpix/archive/refs/tags/v1.0.3.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- tpix (cli)
- tpix (alias)

## Build dependencies

- nim

## 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.0.3
- Local data: ok
- Upstream repository: https://github.com/jesvedberg/tpix
- Upstream latest detected: v1.0.3 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

tpix is a small terminal image viewer built around the Kitty graphics protocol. Its README presents it as a simple Nim program that can render common image formats directly in compatible terminals.

### Project history

The project was created in 2022 by Jesper Vedberg as a personal answer to a remote-computing workflow problem. The README explains that the author, working as a bioinformatician on remote servers and clusters without root access, wanted an easy way to inspect plots over SSH after moving from iTerm2 on macOS to Kitty on Linux.

The implementation choice reflects that origin: tpix was written in Nim so it could be compiled and cross-compiled into small, statically linked binaries that could be copied to systems where the user could not install packages globally. GitHub release metadata shows four 1.0.x releases between May and June 2022.

### Adoption history

tpix remains a niche package-manager tool. Its upstream README documents release binaries for Linux and macOS, source installation through Nimble, and testing with Kitty, WezTerm, and Konsole. Homebrew packages it as `tpix`, making the single-purpose terminal image viewer available through the normal Unix package workflow.

### How it is used

Typical use is direct and Unix-like: run `tpix image.jpg` or pipe image data through standard input. The tool resizes images to terminal width by default and exposes flags for dimensions, background handling, filename printing, and resize behavior.

### Why package nerds care

For package collectors, tpix is notable less as a large application than as a tidy example of the post-Kitty terminal graphics ecosystem: a tiny compiled CLI, packaged for Homebrew, that solves the remote-server 'quickly inspect an image' workflow without a GUI or root privileges.

### Timeline

- 2022-04: GitHub repository created.
- 2022-05: v1.0.0 released.
- 2022-06: v1.0.3 released.

### Related projects

- Kitty, WezTerm, Konsole, Nim, Pixie, Cligen, iTerm2 terminal image workflows.

### Sources

- <https://api.github.com/repos/jesvedberg/tpix>
- <https://github.com/jesvedberg/tpix#readme>
- <https://github.com/jesvedberg/tpix/releases>
- source_facts.package-manager


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** tpix
- **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


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [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.
- [nim](https://www.automicvault.com/pkg/brew/nim/) - Build dependency declared by Homebrew.
- [aview](https://www.automicvault.com/pkg/brew/aview/) - Shares av.db curated category or tags: cli, image-viewer, media, terminal.
- [catimg](https://www.automicvault.com/pkg/brew/catimg/) - Shares av.db curated category or tags: cli, image-viewer, media, terminal.
- [timg](https://www.automicvault.com/pkg/brew/timg/) - Shares av.db curated category or tags: cli, image-viewer, media, terminal.
- [viu](https://www.automicvault.com/pkg/brew/viu/) - Shares av.db curated category or tags: cli, image-viewer, media, terminal.
- [agg](https://www.automicvault.com/pkg/brew/agg/) - Shares av.db curated category or tags: cli, media, terminal.
- [feh](https://www.automicvault.com/pkg/brew/feh/) - Shares av.db curated category or tags: cli, image-viewer, media.
- [pqiv](https://www.automicvault.com/pkg/brew/pqiv/) - Shares av.db curated category or tags: cli, image-viewer, media.
- [chafa](https://www.automicvault.com/pkg/brew/chafa/) - Shares av.db curated category or tags: cli, media, terminal.
- [lsix](https://www.automicvault.com/pkg/brew/lsix/) - Both packages work with overlapping file formats or content types. Shared terms: cli, graphics, image, image-viewer, media.

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
