Repository navigation
Bookbind 1.3.0
It answers to the command line now
The window is still the main thing: one folder, one button, one book. But the
same engine now answers to a command, which is what you want for a script, a big
pile, or a folder nobody needs to look at.
bookbind open the window
bookbind ~/Books/somewhere open it already looking at that folder
bookbind --cli FOLDER … no window: bind it right here, print JSON
bookbind --cli takes the folder and the names — --author, --title,
--year, --narrator, --cover — and prints one JSON object when it is done,
carrying the same checks the window shows you. --dry-run says what it would
do and changes nothing. --lookup fills empty boxes from iTunes. --titles "<path>=Opening Credits" names a chapter, --keep-originals leaves the sources
where they are, and --restore FOLDER undoes a bind. stdout is JSON and progress
goes to stderr, so it pipes straight into jq.
The command is a shorthand for bookbind_cli.py, which is in the zip next to
app.py — on the small build, python3 Bookbind.app/Contents/Resources/bookbind_cli.py.
It is the app's own engine and not a reimplementation: same ordering, same
verification, same untouched originals.
Two hazards it now handles properly
- A finished
.m4bsitting in the folder is a book, not a chapter. It used to
be picked up as one more source file, which quietly produced a book with the
previous book inside it. It is never taken as a source now; adding one by hand
still works. - Audible
.aafiles are encrypted. A folder holding them used to merge
whatever it could and leave them behind without a word — an incomplete book
that looked finished. It now refuses, names the files, and says they need keys.
--ignore-lockedbinds the readable rest if you tell it to.
Nothing else changed. It still copies the audio rather than re-recording it, it
still checks its own work before touching your originals, and it still never
deletes anything.
Which build to take
Three builds of the same app. Take whichever suits the machine.
-macos.zip — 2 MB, starts instantly. Needs Python and ffmpeg installed:
brew install python3 ffmpeg
python3 -m pip install mutagen
-macos-silicon.zip — M-series Macs. -macos-intel.zip — everything
older. Both are around 70–100 MB and install nothing: Python and ffmpeg are
inside them, built for that architecture.
Either way: unzip, put Bookbind.app wherever you like, and double-click it.
First launch. The app is not signed or notarized, so macOS refuses a plain
double-click. Right-click Bookbind.app → Open → Open. After that it
launches normally.
If something is missing, the app names it and prints the command to fix it.