# Install timg with Homebrew, apk, apt, dnf, MacPorts, Nix, zypper

Terminal image and video viewer. Version 1.6.3 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:timg
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install timg
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install timg
```

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

### Linux

- apk (92%):

```sh
sudo apk add timg
```

  Evidence: Alpine Linux edge package indexes: timg from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install timg
```

  Evidence: Debian stable package indexes: timg from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install timg
```

  Evidence: Fedora Rawhide package metadata: timg from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#timg
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ti/timg/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install timg
```

  Evidence: openSUSE Tumbleweed package metadata: timg from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:timg
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/timg>
- **Version:** 1.6.3
- **Source summary:** Terminal image and video viewer
- **Homepage:** <https://timg.sh/>
- **Repository:** <https://github.com/hzeller/timg>
- **Upstream docs:** <https://github.com/hzeller/timg#readme>
- **License:** GPL-2.0-only
- **Source archive:** <https://github.com/hzeller/timg/archive/refs/tags/v1.6.3.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- timg (cli)
- timg (alias)

## Dependencies

- cairo
- ffmpeg
- gdk-pixbuf
- gettext
- glib
- graphicsmagick
- jpeg-turbo
- libdeflate
- libexif
- libpng
- librsvg
- libsixel
- openslide
- poppler
- webp

## Build dependencies

- cmake
- pkgconf

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

timg is a terminal image and video viewer that renders media using terminal graphics protocols or Unicode/block-character fallbacks.

### Project history

The official repository describes timg as a user-friendly terminal viewer for images and videos. It supports Sixel, Kitty, and iTerm2 graphics protocols for full-resolution display, with 24-bit color and Unicode block fallbacks for terminals without graphics support.

The official GitHub releases show v0.9.0 as the first public release in June 2016. Later releases added features such as video playback, iTerm2 graphics support, Kitty graphics support, grid display, and maintenance fixes, with v1.6.3 published in 2025.

### Adoption history

timg was adopted in the terminal-media niche as modern terminals gained richer image protocols. The input package-manager data lists apk, Homebrew, Debian, Fedora, MacPorts, Nix, Ubuntu, and openSUSE, showing that it moved beyond a single-distro novelty.

Its packaging footprint reflects demand from users who want previews over SSH, inside terminal file-manager workflows, or during command-line media triage.

### How it is used

The common use case is quick visual inspection without leaving the shell: displaying images, animated GIFs, videos, and other supported media directly in a terminal.

In terminals with graphics protocol support, timg can display real image data; otherwise it degrades to block-based representations that are still useful for previews.

### Why package nerds care

timg is notable to package nerds because it sits at the intersection of terminal capability detection, graphics protocol support, and lightweight CLI media tooling.

It is often compared with other terminal viewers such as chafa, viu, catimg, and sixel-oriented tools, but its package appeal comes from combining image, GIF, and video preview behavior in one installed command.

### Timeline

- 2016-06: v0.9.0 first public release.
- 2021-02: v1.0.0 release added grid display, threaded loading, and long options.
- 2021-03: v1.2.0 highlighted iTerm2 graphics support and v1.1.0 highlighted Kitty graphics support.
- 2025-09: v1.6.3 maintenance release published.

### Related projects

- Related terminal image tools include chafa, viu, catimg, imgcat, and other Sixel, Kitty, or iTerm2 graphics viewers.

### Sources

- <https://api.github.com/repos/hzeller/timg/releases - official GitHub releases identify v0.9.0 first public release and later feature milestones.>
- <https://github.com/hzeller/timg - official README describes terminal graphics protocols, fallback rendering, images, and videos.>
- input.source_facts.package-manager - package-manager availability lists apk, Homebrew, Debian, Fedora, MacPorts, Nix, Ubuntu, and openSUSE.


## 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:** timg
- **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

- Debian apt - timg - 1.6.0-1+b1: normalized package name match | Debian stable package indexes: timg from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | terminal image and video viewer | https://github.com/hzeller/timg
- Nix - timg: normalized package name match | nixpkgs package indexes: pkgs/by-name/ti/timg/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - timg - 1.5.2-1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: timg from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | terminal image and video viewer | https://github.com/hzeller/timg
- apk - timg - 1.6.3-r0: normalized package name match | Alpine Linux edge package indexes: timg from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | 24-Bit color image viewer for terminal | https://github.com/hzeller/timg
- apk - timg-doc - 1.6.3-r0: normalized package name match | Alpine Linux edge package indexes: timg-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | 24-Bit color image viewer for terminal (documentation) | https://github.com/hzeller/timg
- dnf - timg - 1.6.3-5.fc44: normalized package name match | Fedora Rawhide package metadata: timg from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | A terminal image and video viewer | https://github.com/hzeller/timg
- zypper - timg - 1.6.3-1.6: normalized package name match | openSUSE Tumbleweed package metadata: timg from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Terminal image viewer | https://github.com/hzeller/timg
- MacPorts - timg: normalized package name match | MacPorts ports tree: graphics/timg/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.
- [cairo](https://www.automicvault.com/pkg/brew/cairo/) - Runtime dependency declared by Homebrew.
- [ffmpeg](https://www.automicvault.com/pkg/brew/ffmpeg/) - Runtime dependency declared by Homebrew.
- [gdk-pixbuf](https://www.automicvault.com/pkg/brew/gdk-pixbuf/) - Runtime dependency declared by Homebrew.
- [gettext](https://www.automicvault.com/pkg/brew/gettext/) - Runtime dependency declared by Homebrew.
- [glib](https://www.automicvault.com/pkg/brew/glib/) - Runtime dependency declared by Homebrew.
- [graphicsmagick](https://www.automicvault.com/pkg/brew/graphicsmagick/) - Runtime dependency declared by Homebrew.
- [jpeg-turbo](https://www.automicvault.com/pkg/brew/jpeg-turbo/) - Runtime dependency declared by Homebrew.
- [libdeflate](https://www.automicvault.com/pkg/brew/libdeflate/) - Runtime dependency declared by Homebrew.
- [cmake](https://www.automicvault.com/pkg/brew/cmake/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - 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.
- [tpix](https://www.automicvault.com/pkg/brew/tpix/) - 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.
- [feh](https://www.automicvault.com/pkg/brew/feh/) - Shares av.db curated category or tags: cli, image-viewer, media.
- [lsix](https://www.automicvault.com/pkg/brew/lsix/) - Shares av.db curated category or tags: cli, image-viewer, media, sixel, terminal.
- [pqiv](https://www.automicvault.com/pkg/brew/pqiv/) - Shares av.db curated category or tags: cli, image-viewer, media.
- [catimg](https://www.automicvault.com/pkg/brew/catimg/) - Shares av.db curated category or tags: cli, image-viewer, media, terminal.
- [terminalimageviewer](https://www.automicvault.com/pkg/brew/terminalimageviewer/) - Shares av.db curated category or tags: cli, image-viewer, media, terminal.
- [geeqie](https://www.automicvault.com/pkg/brew/geeqie/) - Both packages work with overlapping file formats or content types. Shared terms: cairo, cli, gdk, gdk-pixbuf, gettext.
- [chafa](https://www.automicvault.com/pkg/brew/chafa/) - Both packages work with overlapping file formats or content types. Shared terms: cairo, cli, gdk, gdk-pixbuf, gettext.

## Combined YAML source

View the package source record on GitHub. [combined/timg.yml](https://github.com/automic-vault/db/blob/main/combined/timg.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
- external package-manager database matches
- cross-ecosystem install command graph