Terminal Animated GIF Viewer 📽️

(Check out the Screenshots for more demos of how it works!)

LPX is a tool for displaying GIF animations directly in the terminal.

It features the following capabilities:

• Image rendering using image display protocols (iTerm2, kitty)
• Interactive controls such as play, pause, and frame-by-frame stepping
• Loop playback of a selected range
• Flexible display modes, including full-screen and inline viewing

The following image protocols are supported:

• Inline Images Protocol (iTerm2)
• Terminal graphics protocol (kitty)

Confirmed working terminal emulators are listed below. Other emulators supporting these protocols may also work, though they have not been explicitly tested.

• iTerm2
• WezTerm
• VSCode integrated terminal *1 *2

*1 Requires the terminal.integrated.enableImages setting to be enabled.

*2 Any terminal emulator using xterm.js (like the VSCode terminal) may work if the image display feature is enabled.

• kitty
• Ghostty

• Sixel graphics is not supported.
• Terminal multiplexers (screen, tmux, Zellij, etc.) are not supported.
• Windows is not supported.

$ cargo install --locked lpx

$ brew install lusingander/tap/lpx

$ paru -S lpx

You can download pre-compiled binaries from releases.

After installation, run the following command:

$ lpx path/to/your/image.gif

LPX - Terminal Animated GIF Viewer 📽️

Usage: lpx [OPTIONS] <FILE>

Arguments:
  <FILE>  Path to the image file

Options:
  -p, --protocol <TYPE>    Select the graphics protocol [default: auto] [possible values: auto, iterm, kitty]
  -n, --frame-step <N>     Number of frames to skip per step action [default: 10]
  -w, --max-width <WIDTH>  Limit the maximum width of the UI
  -i, --inline <HEIGHT>    Enable inline mode with the specified height in rows
  -h, --help               Print help
  -V, --version            Print version

MIT