# hackerb9/lsix

Like "ls", but for images. Shows thumbnails in terminal using sixel graphics.

Repository: https://github.com/hackerb9/lsix
Canonical: https://ross.abutalabs.com/products/lsix
Language: Shell
License: GPL-3.0
License Family: copyleft
Topics: sixel-graphics, graphics, imagemagick, montage, thumbnails, ls, files, terminal, terminal-graphics, xterm, vt340
Last push: 2024-06-20T15:12:30+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3376, "days_push": 804, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4174, forks 124 (observed 2026-08-28T04:08:38.130590+00:00)

## What it is
lsix is a shell script that displays image thumbnails directly in the terminal using sixel graphics, powered by ImageMagick. It works like 'ls' for images, detecting terminal capabilities, background colors, and expanding multi-frame files like GIFs.

## Use cases
- preview image thumbnails in the terminal
- list images on a remote server over ssh
- view all frames of a GIF in the terminal
- browse svg, eps, pdf, and xcf files from the command line
- identify images on a web server without downloading them

## When to choose
- you use a sixel-capable terminal like xterm or vt340
- you want to preview images over ssh without a GUI
- you live in the terminal and want quick image identification

## When to avoid
- your terminal does not support sixel graphics
- you need a full graphical image browser with zoom and editing
- you need fast rendering of large PDFs or complex formats

## Facets
- artifact type: cli-tool
- maturity: stable
- function: image-processing, cli, file-system
- domain: files, graphics, developer-tools
- platform: cli, cross-platform
- tags: sixel, thumbnails, imagemagick, terminal-graphics, shell, command-line, linux, macos

## Member repositories
- hackerb9/lsix (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:38.130590+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:22:43.368950+00:00, confidence not recorded.
  - readme: https://github.com/hackerb9/lsix (fetched 2026-08-28T04:08:38.130590+00:00, sha 0d1b2abb1308)
- Data as of 2026-08-30T08:39:29.467469+00:00.