tigris & euphrates: comic book archival utilities

March 25, 2026 Ā· View on GitHub

Lint license

DISCLAIMER

For personal archival purposes only.

SUMMARY

tigris helps to automate the painstaking task of archiving electronic comic books.

EXAMPLE

Open Kindle to the start of your favorite comic book.

Use Window -> Full Screen Tile -> Left of Screen to tile Kindle into a left half-fullscreen orientation.

Then run our special archival utilities:

% cd ~/Downloads

% tigris

% euphrates

% zip -r euphrates.cbz euphrates

% unzip -tvl euphrates.cbz
Archive:  euphrates.cbz
    testing: euphrates/   OK
    testing: euphrates/000.png   OK
    testing: euphrates/001.png   OK
    testing: euphrates/002.png   OK
...

DOWNLOAD

git clone https://github.com/mcandre/tigris.git ~/src/github.com/mcandre/tigris

Prerequisites

Postinstall

Register "$HOME/src/github.com/mcandre/tigris/bin to PATH environment variable.

For details on tuning tigris & euphrates, see CONFIGURATION.

For details on building from source, see DEVELOPMENT.

RBAC

Warning: The first several runs of the application may trigger OS permission prompts, for the console emulator, Script Editor, and/or tigris.

Repeat until all permission prompts appear to be resolved:

  1. Grant the permission to the respective application(s).
  2. Quit and relaunch the terminal emulator.
  3. Retry the operation.

Recommend prototyping archival scans with a small frame count (e.g. 3) in order to accelerate troubleshooting.

RESOURCES

Prior art, personal plugs, and tools for managing digital content.

šŸŒ¾