harmonica: comic book repackager
March 25, 2026 · View on GitHub
=[][][]=
Fig 1. beeg harmonica
SUMMARY
harmonica repackages comics into batches of smaller collections.
EXAMPLE
% cd examples
% harmonica -n 36 atomic-war
% tree issue-*
issue-1
├── Atomic_War_no.1_195211_pg00a.jpg
├── Atomic_War_no.1_195211_pg00b.jpg
├── Atomic_War_no.1_195211_pg01.jpg
├── Atomic_War_no.1_195211_pg02.jpg
├── Atomic_War_no.1_195211_pg03.jpg
...
issue-2
├── Atomic_War_no.2_195212_pg00a.jpg
├── Atomic_War_no.2_195212_pg00b.jpg
├── Atomic_War_no.2_195212_pg01.jpg
├── Atomic_War_no.2_195212_pg02.jpg
├── Atomic_War_no.2_195212_pg03.jpg
...
DOWNLOAD
| OS | Package | |
|---|---|---|
| macOS 26 Tahoe+ | ARM | Intel |
| Ubuntu / WSL 2+ | ARM | Intel |
For more platforms and installation methods, see INSTALL.
For details on tuning harmonica, see CONFIGURATION.
For details on building from source, see DEVELOPMENT.
ABOUT
harmonica chunks comics ebooks into smaller ebooks. This mitigates glitches when transfering or reading ebooks.
NOTE
When sourcing the current working directory (.), then the targets automatically reposition up to the parent directory, treating the source as immutibile. This reduces the risk of successive harmonica operations nesting archives inside each other.
WARNING
Nested directories within ebooks are currently unsupported.
When in doubt, backup source files onto a separate volume before running harmonica.
RESOURCES
Personal plugs and tools for managing digital content.
- mcandre/buttery - an animated GIF editor
- mcandre/tigris - (Kindle) comic book archival utilities
- tree - recursive directory browser
- zip - base archive format for many ebooks
HHH
Fig 2. smol harmonica