Automic VaultAutomic Vault

brew

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 commandSecurity notes

install

Additional install commands

macOS

Homebrewverified · 100%
brew install timg

local Homebrew formula metadata

MacPortsverified · 94%
sudo port install timg

MacPorts ports tree · graphics/timg/Portfile · source: api.github.com

Linux

Alpine Linux apkverified · 92%
sudo apk add timg

Alpine Linux edge package indexes · timg · source: dl-cdn.alpinelinux.org

Debian aptverified · 92%
sudo apt install timg

Debian stable package indexes · timg · source: deb.debian.org

Fedora dnfverified · 92%
sudo dnf install timg

Fedora Rawhide package metadata · timg · source: dl.fedoraproject.org

Nixverified · 92%
nix profile install nixpkgs#timg

nixpkgs package indexes · pkgs/by-name/ti/timg/package.nix · source: api.github.com

openSUSE zypperverified · 92%
sudo zypper install timg

openSUSE Tumbleweed package metadata · timg · source: download.opensuse.org

overview

Package summary

Terminal image and video viewer

Commands and aliases

  • timg

history

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.

security posture

Risk level: blue

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

Risk classifier

blue risk · medium confidence · tool

Why

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

Signals

  • text:video,image

Install behavior

  • No Homebrew post-install hook is recorded in formula metadata.
  • Homebrew bottle metadata is available for 6 platform targets.
  • Installs with 15 runtime dependencies.
  • Build metadata lists 2 build dependencies.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

executables

Installed executables

CommandKindExposureNote
timgcliglobal executable

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-07-08
manager version1.6.3
manager updated
local dataok
upstreamcurrent
latest detectedv1.6.3

https://github.com/hzeller/timg

  • infoNo package-manager update timestamp was available.low confidence

install metadata

Package metadata

Package keybrew:timg
Version1.6.3
Package managerHomebrew
Package manager pagehttps://formulae.brew.sh/formula/timg
Homepagehttps://timg.sh/
Repositoryhttps://github.com/hzeller/timg
Upstream docshttps://github.com/hzeller/timg#readme
LicenseGPL-2.0-only
Source archivehttps://github.com/hzeller/timg/archive/refs/tags/v1.6.3.tar.gz
Dependenciescairo, ffmpeg, gdk-pixbuf, gettext, glib, graphicsmagick, jpeg-turbo, libdeflate, libexif, libpng, librsvg, libsixel, openslide, poppler, webp
Build dependenciescmake, pkgconf
Bottleavailable (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux)
Homebrew post-installnot defined
Servicenone declared

registry facts

Source database details

Source DatabaseHomebrew formula API
Taphomebrew/core
Full Nametimg
Version Scheme0
Revision0
Head VersionHEAD
Bottle Stable Root URLhttps://ghcr.io/v2/homebrew/core
Deprecatedno
Disabledno
Keg Onlyno
URL Keys
  • head
  • stable

source database matches

Other package-manager records

Matches are pulled from external package-manager indexes and kept separate from local Automic Vault package links.

Debian apt95%

timg 1.6.0-1+b1

terminal image and video viewer

https://github.com/hzeller/timg

sudo apt install timg
  • Section: graphics
  • Architecture: amd64
  • Source Package: timg
  • 19 dependencies
  • normalized package name match
  • Matched by: Timg
Debian stable package indexes · deb.debian.org · Debian stable package indexes: timg from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz
Nix95%

timg

nix profile install nixpkgs#timg
  • normalized package name match
  • Matched by: Timg
nixpkgs package indexes · api.github.com · nixpkgs package indexes: pkgs/by-name/ti/timg/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
Ubuntu apt95%

timg 1.5.2-1build2

terminal image and video viewer

https://github.com/hzeller/timg

sudo apt install timg
  • Section: universe/graphics
  • Architecture: amd64
  • 15 dependencies
  • normalized package name match
  • Matched by: Timg
Ubuntu 24.04 LTS package indexes · archive.ubuntu.com · Ubuntu 24.04 LTS package indexes: timg from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz
apk95%

timg 1.6.3-r0

24-Bit color image viewer for terminal

https://github.com/hzeller/timg

sudo apk add timg
  • License: GPL-2.0-only
  • Architecture: x86_64
  • Source Package: timg
  • 1 dependencies
  • 1 provides
  • normalized package name match
  • Matched by: Timg
Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: timg from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz
apk95%

timg-doc 1.6.3-r0

24-Bit color image viewer for terminal (documentation)

https://github.com/hzeller/timg

sudo apk add timg-doc
  • License: GPL-2.0-only
  • Architecture: x86_64
  • Source Package: timg
  • normalized package name match
  • Matched by: Timg
Alpine Linux edge package indexes · dl-cdn.alpinelinux.org · Alpine Linux edge package indexes: timg-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz
dnf95%

timg 1.6.3-5.fc44

A terminal image and video viewer

https://github.com/hzeller/timg

sudo dnf install timg
  • License: GPL-2.0-only AND MIT AND (MIT OR Unlicense)
  • Category: Unspecified
  • Architecture: x86_64
  • Source Package: timg
  • 21 dependencies
  • 1 provides
  • normalized package name match
  • Matched by: Timg
Fedora Rawhide package metadata · dl.fedoraproject.org · Fedora Rawhide package metadata: timg from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst
zypper95%

timg 1.6.3-1.6

Terminal image viewer

https://github.com/hzeller/timg

sudo zypper install timg
  • License: GPL-2.0-only
  • Category: Unspecified
  • Architecture: x86_64
  • Source Package: timg
  • 19 dependencies
  • 1 provides
  • normalized package name match
  • Matched by: Timg
openSUSE Tumbleweed package metadata · download.opensuse.org · openSUSE Tumbleweed package metadata: timg from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst
MacPorts95%

timg

sudo port install timg
  • normalized package name match
  • Matched by: Timg
MacPorts ports tree · api.github.com · MacPorts ports tree: graphics/timg/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

Related tools

  • cairoRuntime dependency declared by Homebrew.
  • ffmpegRuntime dependency declared by Homebrew.
  • gdk-pixbufRuntime dependency declared by Homebrew.
  • gettextRuntime dependency declared by Homebrew.
  • glibRuntime dependency declared by Homebrew.
  • graphicsmagickRuntime dependency declared by Homebrew.
  • jpeg-turboRuntime dependency declared by Homebrew.
  • libdeflateRuntime dependency declared by Homebrew.

Same workflow

  • aviewShares av.db curated category or tags: cli, image-viewer, media, terminal.
  • tpixShares av.db curated category or tags: cli, image-viewer, media, terminal.
  • viuShares av.db curated category or tags: cli, image-viewer, media, terminal.
  • fehShares av.db curated category or tags: cli, image-viewer, media.
  • lsixShares av.db curated category or tags: cli, image-viewer, media, sixel, terminal.
  • pqivShares av.db curated category or tags: cli, image-viewer, media.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Used sources

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