cullet

Keyboard-driven photo viewer for going through a folder fast: step, zoom, rotate, delete, move into target folders, tag, and review duplicates. Press h in the viewer for the keys.

Install

Requires python>=3.10

uv tool install cullet

or pip install cullet into an environment of your choice. Rotating JPEGs losslessly needs the jpegtran binary, which comes with libjpeg-turbo on most distributions.

Finding duplicates and fixing rotations need torch, which comes with the full extra:

uv tool install "cullet[full]"

Usage

cullet /path/to/photos
cullet /path/to/photos/IMG_1234.jpg
cullet /path/to/photos -a ../good -a ../maybe -T sun -T portrait
cullet /path/to/photos --dedup

The number keys move the image into the target folders (-a) and toggle the tags (-T), in the order they are given. Deleted files are moved to the system trash, never removed (--trash_dir puts them into a folder of your choice instead), and every file operation can be undone with u. cullet --help lists all options.

Command line tools

They only log what they would do until -w is given. Each has --help.

cullet-dedup-videos /path/to/videos -Q /path/to/quarantine -w
cullet-downscale-images /path/to/photos -s 1080 -w

Install locally and run tests

Clone repository and cd into. Setup python 3.10 or higher. Note: The tests that need torch are skipped unless it is installed.

pip install -e .[full,dev]
pylint src

# run tests
python -m pytest --cov
pylint tests