📚 How to install & use BookBinder

BookBinder helps you catalogue every book in your home using your phone camera and Claude AI. Choose your install method below, then follow the cataloguing steps.

1

Install Docker Desktop

Download and install Docker Desktop from docker.com — it's free.

  • Mac: download the .dmg, drag to Applications, launch it
  • Windows: download the installer, run it, restart if asked
  • Linux: follow the instructions at docs.docker.com/engine/install

When Docker starts up, it will offer to create an account — you don't need one.
Look for the small 'Skip' link in the top right of that screen

Wait until Docker Desktop shows "Docker is running" before continuing.

2

Download and unzip BookBinder

Download BookBinder from the download page and unzip it into a permanent folder — somewhere like Documents/BookBinder/ rather than Downloads, as Docker needs to find it each time you start.

3

Start BookBinder

🍎 Mac — easiest: download the Mac Launcher and double-click BookBinder Launcher.app — it starts BookBinder and opens your browser automatically. No Terminal needed.
⚠️ Mac users: wherever you put BookBinder Launcher.app when you first double-click it, that's where BookBinder will be installed. Choose a permanent location — such as your Applications folder or Documents — before running it for the first time.
🪟 Windows — easiest: unzip the BookBinder download, then right-click Install BookBinder.bat and choose Run as administrator. A progress window will guide you through — it asks where to install (defaults to Documents) and opens your browser when ready.

Managing via Docker Desktop

After installation, open Docker Desktop and you'll see your software listed with Start and Stop buttons. You can start and stop from there at any time (or just quit Docker to stop).

Linux / command line: navigate to the bookbinder folder and run:

docker compose up -d

Then open http://localhost:8585 in your browser.

phpMyAdmin is also available at http://localhost:8586 if you ever need direct database access.

⏱ The first run takes a minute or two to download. Every start after that is instant.
🔁 Next time: make sure Docker Desktop is open (launch it and wait for "Docker is running" if it's not), then double-click BookBinder Launcher.app (Mac) or start.bat (Windows) again — that's all you need to do.
4

Set your editor password

Open app/config.php in any text editor and find this line:

define('BB_EDIT_PASS_HASH', password_hash('bookbinder', PASSWORD_DEFAULT));

Replace bookbinder with your chosen password. Anyone can browse your catalogue — only someone with this password can edit it.

5

Photograph, zip and upload to Claude

See Cataloguing your books below — it's the same for everyone.

6

Import the SQL Claude generates

Log in to edit (default password is 'bookbinder' change in config as above if required), then go to Import SQL in the top menu. Paste the SQL Claude gives you, or upload it as a .sql file — check the preview, then confirm.

✅ Uses INSERT IGNORE — safe to re-run as many times as you like. Import runs as a single transaction, so a mistake can't leave your catalogue half-updated.

Cataloguing your books

These steps are the same whether you used Docker or a manual install.

A

Take photos of your bookcase shelves

For best results:

  • One shelf per photo — don't try to capture the whole bookcase in one shot
  • Straight on — stand directly in front of the shelf, not at an angle
  • Good light — natural daylight or overhead; avoid flash glare on spines
  • Fill the frame — get close enough that spine text is readable
  • One wide-angle overview shot per bookcase too — useful for the bookcase card photo
  • See also How to photograph your shelves opens in new tab
📱 Tip: 3–5 close-up shelf shots per bookcase, then one overview. iPhone or Android both work fine.
B

Zip the photos for each bookcase

Group each bookcase's photos into a folder and zip it. Name it clearly:

  • bcase1_lounge_main.zip
  • bcase2_hall_by_stairs.zip
  • bcase3_study.zip

Mac: select photos → right-click → Compress.
Windows: select photos → right-click → Send to → Compressed folder.

💡 You can do multiple bookcases at once — just zip them separately and upload together.
C

Open a new chat with Claude

Go to claude.ai and start a new chat. Paste this prompt:

I'm cataloguing my home library using BookBinder. I'll upload zipped photos of each bookcase and I need you to:

1. Read all the book spines in the photos
2. Generate SQL INSERT statements in this format:

INSERT IGNORE INTO books (title, author, category, sub_category, bookcase, shelf, location_name, notes) VALUES
('Title Here', 'Author Name', 'Category', 'Sub-category or NULL', BOOKCASE_NUMBER, SHELF_NUMBER, 'Room Name', 'any notes');

Rules:
- category should be one of: Fiction, Non-Fiction, Sailing, Medical, TEFL, Reference, Gardening, Cookery, Art, Music, Humour, Games, Sport, Motoring, Health, Poetry, Nature, Travel, DIY, Magazines
- sub_category for Medical: Anatomy, Osteopathy, Homeopathy, Nutrition, Physiotherapy, Orthopaedics, Clinical, Alternative Health
- shelf numbers count from top (1=top shelf)
- bookcase number is the number I give you with each upload
- Use NULL for unknown authors
- Flag unclear titles with 'Title unclear - check' in notes

After each bookcase, output the complete SQL block ready to paste into BookBinder's Import SQL page.

Ready — I'll upload bookcase 1 now.
Now you can login to BookBinder and import the SQL that Claude produces or paste it in (choose Import SQL top right after login)
D

Upload your zip files to Claude

Drag your zip files into the Claude chat. Tell Claude which bookcase number each one is and what room it's in:

These are bookcases 1, 2 and 3.
Bookcase 1 = Lounge
Bookcase 2 = Hall by stairs
Bookcase 3 = Study

Claude reads the spines and generates the SQL for each bookcase.

💡 If a title is hard to read, Claude flags it in the notes column so you can check later.
E

Add bookcase photos (optional but lovely)

Log in and go to the Bookcases page. Upload your overview shot for each bookcase — it appears on the bookcase card so you can see at a glance where a book lives.

F

Browse, search and tidy up

On the Browse page you can:

  • Search by title or author
  • Filter by bookcase or category using the sidebar
  • Expand categories with a ▶ arrow to filter by sub-category
  • Edit any book inline with the ✏️ button (log in first)
  • Add books manually with the + Add Book button
  • Mark books as lent out and record who has them
💡 Books flagged as 'Title unclear' are worth a quick follow-up photo to Claude — a clearer shot of just that shelf usually does it.

Tips for a good catalogue session

Want more from your catalogue? Try ShelfMate

ShelfMate is BookBinder's bigger sibling — same self-hosted approach, plus genre filtering, condition grading, wishlist, purchase value tracking, last read/played dates, CSV export, random pick and batch editing. £10, one-time.

Ready to get started?

⬇ Download BookBinder free