An audiobook is normally one file. A copy of one is often a pile of files — one per
CD track, or one per chapter, sitting in a folder with names like 01.mp3, 02.mp3.
Bookbind turns that pile into a single .m4b: the file type Apple Books, iPhones, iPods
and most audiobook players understand, with a real chapter list you can skip around in.
It checks its own work as it goes, and it never deletes anything.
You do not need to know what an .m4b is, or what "chapter list" means technically. Point
it at the folder, press the button, and you get one book.
A file that is already whole is a job too: hand it one track and it comes back as a tagged
.m4b with a chapter list of its own, rather than being turned away.
Bookbind.app is a Mac app with its own window and its own Dock icon. It does not open a
browser tab, and there is no address bar anywhere: the window you get is the whole program.
Folders and files are chosen in the normal Mac way — the Choose folder button opens a Finder panel, and Add files opens the same panel for individual tracks. Nothing is browsed by typing a path.
You can also drop things straight onto the window. Drag a folder in from the Finder and
it becomes the book's folder — the one the .m4b is written into and the one the originals
are moved aside inside. Drag loose audio files in and they are added to the chapter list you
already have. A veil comes up while you are holding them there, so you can see the window is
ready; a drop of anything that is not audio says so rather than doing nothing.
A web page is never told where a dropped file lives, so this is caught by the app itself, one layer above the page — that is the only way a dropped folder can become a real folder rather than an upload. It works in
Bookbind.appand in Housekeeping's Bookbind screen. Open the page in an ordinary browser and dragging gets you a note saying exactly that.
There are two lists, because they answer different questions:
- 1 · The folder — one folder, and everything in it. This is the usual way: a folder of tracks becomes a book, in order.
- 2 · The chapters — the actual list of files that will become chapters. It opens as the folder's contents, and each row can then 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. Add files… puts one in from anywhere else on the disk.
That second list is what you use when you want to match a track list you found online: type each chapter's real name, put them in the right order, leave out the interviews, and the book comes out named the way the publisher did it.
The window and the command line are the same engine, so nothing here is a second
implementation that can drift: everything below calls the app's own app.py.
bookbind # open the window
bookbind ~/Books/somewhere # open it already looking at that folder
bookbind --cli FOLDER … # no window: bind it right here, print JSONbookbind is a shorthand (~/.local/bin/bookbind). --cli passes the rest through to
bookbind_cli.py, which is in this folder and can also be called directly:
python3 bookbind_cli.py "/Books/Hammett, The Maltese Falcon (1930)" \
--author "Dashiell Hammett" --title "The Maltese Falcon" --year 1930It prints one JSON object on stdout and its progress on stderr, so | jq stays clean.
The folder's name is read the way the window reads it — Hammett, The Maltese Falcon (1930) fills in all three — but an author is never guessed. Useful flags: --dry-run
(say what would happen, change nothing), --lookup (fill empty year, narrator and cover
from the top iTunes hit), --titles "<path>=Opening Credits" (name one chapter, can
repeat), --order auto|path|tags, --keep-originals, and --restore FOLDER to undo.
--help lists the lot.
If the app is already open, bookbind FOLDER cannot retarget it — macOS hands a running
app no arguments — so it says so rather than opening the wrong folder in silence.
- Look. You hand it a folder. It tells you what audio it found there, how long it runs in total, how many files already have tags, and guesses the author and title from the folder's name.
- Ask. Type the author and title and it looks the book up online (iTunes). You get back the release year, the narrator, and a cover picture. Pick the right edition and the boxes fill themselves in — and every box stays editable, including "no cover at all".
- Bind. It joins the files into one
.m4b, with one chapter per source file, in the order the files should play (it understands that2.mp3comes before10.mp3, not after). By default it copies the audio rather than re-recording it, so the sound is exactly what you started with and cannot get worse. A panel comes up the moment you press the button and stays for the life of the run: planning, a real progress bar with the time done out of the time total, then checking, then moving the originals aside — and when it lands, Saved, with the exact path the book was written to and a Show in Finder button. It can be sent to the background and brought back with Progress on the job in the list; closing it never stops a run. - Check. Before touching your originals it inspects the new file: is it the same length, does it have one chapter per file, do the very first and very last seconds actually play, did the tags land, is the cover really inside it. If any answer is wrong it throws its own output away and tells you why. Your files stay put.
- Tidy up. The original files move into an
_originalsfolder next to the new book — moved, never deleted. If you don't like the result, one click (Undo) puts them all back and removes the merged file.
It accepts mp3, m4a, m4b, aac, flac, opus, wav, ogg and wma, and will mix formats within one book if it has to.
Three builds of the same app. Take whichever suits the machine, from
Releases. Unzip it and put
Bookbind.app wherever you like — Applications, Desktop, anywhere.
| Asset | Size | Macs it runs on | Needs |
|---|---|---|---|
Bookbind-<version>-macos-silicon.zip |
~70 MB | M1, M2, M3, M4 … | nothing — everything is inside |
Bookbind-<version>-macos-intel.zip |
~72 MB | older Intel Macs | nothing — everything is inside |
Bookbind-<version>-macos.zip |
~2 MB | either | Python 3 with mutagen, and ffmpeg |
Not sure which Mac you have? Apple menu → About This Mac. If the chip says Apple M… take the silicon one; if it says Intel take the intel one.
The two big ones already contain the Python and the ffmpeg they need — that is the whole point of them, and why they are large. The small one is for people who already have those installed (or would rather have them):
brew install python3 ffmpegpython3 -m pip install mutagenIf one of those is missing, the app tells you which and prints the command to fix 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.
python3 app.pyand open http://127.0.0.1:8765. Needs python3, mutagen, and ffmpeg/ffprobe on
PATH.
In a browser there is no Finder panel to call, so the page offers a path box and its own folder walker instead, and the window is a browser tab. The Mac app is the same page with that one difference.
- The app's window is
build/window.swift, compiled toBookbind.app/Contents/MacOS/Bookbindby./build/make_window.sh. That binary is committed on purpose: the small-macos.zipis assembled on a Linux runner that has no Swift compiler, and all three builds should ship the same window. It is compiled for both architectures at once, so it opens on Intel and Apple silicon alike.window.swiftstarts the Python server, points a web view at it, and answers three things the page asks for — pick a folder, pick files, show something in the Finder. Anything else the app does is stillapp.py. - The server holds its jobs in memory, so an Undo offered by a job that was running before you quit the app will say the manifest is gone. The manifest file itself is still on disk next to the book, so nothing is lost.
build/make_icon.pyregenerates the app icon and the header png from a flat source image on a solid page: it keys the page out, sizes the shape to Apple's icon grid (824 of a 1024 canvas) and writes both the.icnsandstatic/icon.png.- Cover art is written as an
attached_picmjpeg stream, which is what Apple Books, iTunes and most players read. Chapters are written as MP4 chapter tracks — in these files they appear as abin_datastream alongside the audio, which is normal and not a problem.