Repository navigation
Releases
Bookbind 1.5.2
1.5.2 — progress stays live while a bind is running
The job worker held the queue's lock for the whole encode. The page asks the job
list for an update once a second so it can move the progress bar, and that
question waited behind ffmpeg until the encode ended. The screen therefore sat
at "Waiting for the engine", the stage never changed, and Stop looked broken.
The lock now guards the job-table claim only. Work runs outside it, and
task_done() sits in a finally block so a failed job cannot leave the queue
unbalanced. Measured with the same three 150-second tracks: engine 1.5.1 held
/api/jobs for 4.2 seconds and never showed the encoding stage; 1.5.2 answered
the same poll in 1–2 ms and reported encoding while ffmpeg ran. The finished
7 MB M4B has all three chapter marks, the title, artist and album tags.
Housekeeping carries this engine, so its version now needs to be 1.5.2 as well.
The catalogue search works again
Search online catalogue was failing on this Mac with
CERTIFICATE_VERIFY_FAILED: unable to get local issuer certificate
which reads like a broken connection and is not one. A python.org Python on macOS
ships with no root certificates until its Install Certificates.command has
been run, and Python says nothing about that until the first https request: every
TLS connection then fails verification because there is nothing to verify against.
Bookbind's own catalogue search was the first thing on this machine to make one.
The trust store is now chosen rather than assumed — certifi's bundle when it is
installed, macOS's own /etc/ssl/cert.pem when it is not — so the search works on
any Mac that has either, and continues to work on a Python that has been set up
properly. The failure message, if it ever comes back, now says the catalogue could
not be reached and that both fields can be filled by hand.
Verified on this Mac: Greg Grandin / Empire's Workshop returns the audiobook
from the iTunes catalogue, cover included.
The bundle now says which version it is
Every bundled release so far reported 1.5.0 in its Info.plist, whatever it
actually carried, because the version was written by hand in the repository and the
release workflow copied that file as-is. The workflow now stamps the tag's version
into the bundle before it packages it, and the download check fails if the zip's
Info.plist disagrees with its tag.
Drop a folder on it, and watch the run finish
Two things are new, and both are about not having to guess what Bookbind is doing.
Drag and drop
Drag a folder of audio from the Finder onto the window and it becomes the book's
folder — the one the finished .m4b is written into, and the one the originals
are moved aside inside. Its files land in the chapter list in order.
Drag loose audio files instead and they are added to the list you already
have; if you have not chosen a folder yet, Bookbind works out which folder they
all live in and uses that. A dotted strip in the first card says the window takes
drops, and a veil comes up while you are holding files over it, so you can see it
has noticed you. A drop holding nothing playable says so instead of doing nothing.
The drop is caught by the app rather than by the page, because a web page is
deliberately never told where a dropped file lives — and without the real path a
dropped folder cannot become a real folder. Only file URLs are registered, so
dragging text into the title field still behaves as it always did.
The run panel
Make the audiobook now opens a panel and keeps it for the life of that one run:
- Reading the files, while it probes lengths and lays out the chapters.
- Binding the audio, with a real percentage and the audio done out of the total.
- Checking the result, as it compares the new file against what it asked for.
- Moving the originals aside into
_originals. - Saved, with the exact path the book was written to and Show in Finder.
Stop cancels the run and leaves the originals alone. Keep running in the
background closes the panel without stopping anything, and Progress on the
job in the list brings it back. Try again appears only after a failure or a
stop. Closing the panel never stops a run.
Also in this version
A source that already carries a chapter track keeps it, so re-tagging a finished
.m4b no longer flattens thirty named chapters into one; a title typed against a
file still wins for that file, because that is a decision rather than a default.
The command line reports the real chapter count rather than the file count.
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.
Bookbind 1.5.1
The catalogue search works again
Search online catalogue was failing on this Mac with
CERTIFICATE_VERIFY_FAILED: unable to get local issuer certificate
which reads like a broken connection and is not one. A python.org Python on macOS
ships with no root certificates until its Install Certificates.command has
been run, and Python says nothing about that until the first https request: every
TLS connection then fails verification because there is nothing to verify against.
Bookbind's own catalogue search was the first thing on this machine to make one.
The trust store is now chosen rather than assumed — certifi's bundle when it is
installed, macOS's own /etc/ssl/cert.pem when it is not — so the search works on
any Mac that has either, and continues to work on a Python that has been set up
properly. The failure message, if it ever comes back, now says the catalogue could
not be reached and that both fields can be filled by hand.
Verified on this Mac: Greg Grandin / Empire's Workshop returns the audiobook
from the iTunes catalogue, cover included.
The bundle now says which version it is
Every bundled release so far reported 1.5.0 in its Info.plist, whatever it
actually carried, because the version was written by hand in the repository and the
release workflow copied that file as-is. The workflow now stamps the tag's version
into the bundle before it packages it, and the download check fails if the zip's
Info.plist disagrees with its tag.
Drop a folder on it, and watch the run finish
Two things are new, and both are about not having to guess what Bookbind is doing.
Drag and drop
Drag a folder of audio from the Finder onto the window and it becomes the book's
folder — the one the finished .m4b is written into, and the one the originals
are moved aside inside. Its files land in the chapter list in order.
Drag loose audio files instead and they are added to the list you already
have; if you have not chosen a folder yet, Bookbind works out which folder they
all live in and uses that. A dotted strip in the first card says the window takes
drops, and a veil comes up while you are holding files over it, so you can see it
has noticed you. A drop holding nothing playable says so instead of doing nothing.
The drop is caught by the app rather than by the page, because a web page is
deliberately never told where a dropped file lives — and without the real path a
dropped folder cannot become a real folder. Only file URLs are registered, so
dragging text into the title field still behaves as it always did.
The run panel
Make the audiobook now opens a panel and keeps it for the life of that one run:
- Reading the files, while it probes lengths and lays out the chapters.
- Binding the audio, with a real percentage and the audio done out of the total.
- Checking the result, as it compares the new file against what it asked for.
- Moving the originals aside into
_originals. - Saved, with the exact path the book was written to and Show in Finder.
Stop cancels the run and leaves the originals alone. Keep running in the
background closes the panel without stopping anything, and Progress on the
job in the list brings it back. Try again appears only after a failure or a
stop. Closing the panel never stops a run.
Also in this version
A source that already carries a chapter track keeps it, so re-tagging a finished
.m4b no longer flattens thirty named chapters into one; a title typed against a
file still wins for that file, because that is a decision rather than a default.
The command line reports the real chapter count rather than the file count.
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.
Bookbind 1.5.0
Drop a folder on it, and watch the run finish
Two things are new, and both are about not having to guess what Bookbind is doing.
Drag and drop
Drag a folder of audio from the Finder onto the window and it becomes the book's
folder — the one the finished .m4b is written into, and the one the originals
are moved aside inside. Its files land in the chapter list in order.
Drag loose audio files instead and they are added to the list you already
have; if you have not chosen a folder yet, Bookbind works out which folder they
all live in and uses that. A dotted strip in the first card says the window takes
drops, and a veil comes up while you are holding files over it, so you can see it
has noticed you. A drop holding nothing playable says so instead of doing nothing.
The drop is caught by the app rather than by the page, because a web page is
deliberately never told where a dropped file lives — and without the real path a
dropped folder cannot become a real folder. Only file URLs are registered, so
dragging text into the title field still behaves as it always did.
The run panel
Make the audiobook now opens a panel and keeps it for the life of that one run:
- Reading the files, while it probes lengths and lays out the chapters.
- Binding the audio, with a real percentage and the audio done out of the total.
- Checking the result, as it compares the new file against what it asked for.
- Moving the originals aside into
_originals. - Saved, with the exact path the book was written to and Show in Finder.
Stop cancels the run and leaves the originals alone. Keep running in the
background closes the panel without stopping anything, and Progress on the
job in the list brings it back. Try again appears only after a failure or a
stop. Closing the panel never stops a run.
Also in this version
A source that already carries a chapter track keeps it, so re-tagging a finished
.m4b no longer flattens thirty named chapters into one; a title typed against a
file still wins for that file, because that is a decision rather than a default.
The command line reports the real chapter count rather than the file count.
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.
Bookbind 1.4.0
One file is a book too
A lone track used to be turned away — "only one audio file, nothing to merge" —
which was wrong twice over. Plenty of audiobooks arrive as a single file, and the
merge step never needed a second one to work: what that file wanted was the rest
of the job, and the rest of the job already worked.
Hand Bookbind one file and it comes back as a tagged .m4b with a chapter list
of its own — title, author, year, narrator and cover written in, the audio
copied rather than re-encoded when it is already AAC, and the whole thing
checked before the original is touched.
The one case still refused is a single file that is the .m4b this job would
write. That now says so in as many words, instead of failing for a reason that
does not fit.
Nothing else changed: same ordering, same checks, same untouched originals.
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.
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.
Bookbind 1.2.0
It is a real Mac app now
Bookbind used to open a browser tab, and you picked the folder by typing a path
into a box. Both are gone. It is a proper app: its own window, its own Dock
icon, and no address bar anywhere.
- Choose folder opens a Finder panel. Add files opens the same panel for
individual tracks. Nothing is browsed by hand any more. - There are now two lists. The folder is the usual way — one folder, in
order. The chapters is the actual list of files that will become chapters,
and each row can be changed on its own: untick one to leave it out, move one
with the arrows, drop one with ×, or type in its box to give that chapter
your own title. - That second list is what you use when you found a track list online: type each
chapter's real name, put them in order, leave out the interviews, and the book
comes out named the way the publisher did it. - A running job now stays in view while you read the rest of the page, instead of
scrolling away.
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.
Bookbind 1.1.0
Three builds, 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.
Bookbind 1.0.0
One download, nothing to install. Unzip it, put Bookbind.app wherever you like,
and double-click it — the server, the page and the icon all live inside the bundle.
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.
Requirements. It still shells out to Python and ffmpeg:
brew install python3 ffmpeg
python3 -m pip install mutagen
If one of those is missing, the app names it and prints the command to fix it.
Nothing in the bundle is architecture-specific — the same zip runs on Intel and
Apple Silicon.