Skip to content

Bookbind 1.3.0

Choose a tag to compare

@github-actions github-actions released this 29 Sep 16:24
· 10 commits to main since this release

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 .m4b sitting 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 .aa files 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-locked binds 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.