billerbook
Open-source photo book layout for the Mac. Drag & drop, one-key cropping, print-ready PDFs for any print shop, Lightroom Classic import, MCP server for AI assistants.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/tillheidrich--billerbook)HTML
<a href="/listings/tillheidrich--billerbook"><img src="/api/listings/tillheidrich--billerbook/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**Mac:** download the DMG for Apple silicon or Intel from [Releases](https://github.com/tillheidrich/billerbook/releases/latest). The app is signed and updates itself. Until Apple has notarized a release, open it the first time with right-click › *Open* (or allow it under System Settings › Privacy & Security).
**From source (macOS, Linux, Windows):** Node.js 22.13 or newer.
git clone https://github.com/tillheidrich/billerbook.git cd billerbook npm install npm start # opens http://localhost:4580
Projects live in `~/Library/Application Support/Billerbook` on macOS (`~/.billerbook` on Linux, `%APPDATA%\Billerbook` on Windows). Set `BILLERBOOK_DATA` to change it.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 155 lines
- <p align="center"><img src="build/icon.png" width="128" alt="Billerbook icon"></p>
- <h1 align="center">Billerbook</h1>
- <p align="center"><b>Lay out photo books fast. Print them anywhere.</b><br>
- Open source · macOS app · works with Lightroom Classic or any folder · print-ready PDF for every print shop · MCP server for AI assistants</p>
- <p align="center">
- <a href="https://github.com/tillheidrich/billerbook/releases/latest">Download for Mac</a> ·
- <a href="https://billerbook.heidrich-digital.de">Website</a> ·
- <a href="docs/mcp.md">AI / MCP</a> ·
- <a href="#deutsch">Deutsch</a>
- </p>
- 
- *Billerbook* is Low German for picture book. It is the tool I wanted after years of the same routine: pick photos in Lightroom, lay them out in Lightroom's Book module, export a PDF that never quite matched the printer, fix it in InDesign, and fight every crop by hand. Billerbook does the whole thing in one place and writes the PDF the print shop asks for.
- ## What it does
- **One photo pool, several books.** Make the big hardcover for yourself and a shorter portrait softcover for the family from the same photos. Every thumbnail shows which edition already uses it, and the *Missing here* filter lists what is still left out, so the year in photos is actually complete.
- **Layouts that adapt.** 23 page and spread layouts, all calculated from the page size. Copy a landscape hardcover into a portrait softcover and the pages re-flow instead of breaking. The auto grid keeps every photo's aspect ratio, so 3:2 photos are not squeezed into square templates.
- **Cropping without the fiddling.** Drag inside a photo to move the crop, scroll to zoom. `F` switches between *fill the frame* and *show the whole photo*. `V` turns a photo into a full-bleed page. `Space` tries the next arrangement for the same photos. Smart crop finds the subject (saliency detection) and centres it before you touch anything.
- **Free frames when you need them.** Turn any layout into free frames, then Alt+drag to move and drag the corner to resize. Frames snap to margins, centre and gutter.
- **Lightroom Classic, both ways.** Billerbook reads the catalog (also while Lightroom is open), uses your collections as the photo pool, shows Lightroom's previews and picks up captions. Books made in Lightroom's Book module can be imported with their pages, photo positions and crops. Billerbook itself never writes to the catalog. The optional Lightroom plug-in does, and only one thing: it keeps a collection per edition under *Billerbook* in the Collections panel, plus a *missing* collection with the photos that are not in the book yet. So you see in Lightroom which photos are in the book.
- **Everything the Book module does, and more.** Duplicate pages (`⌘D`), copy a page layout and paste it on other pages (`⇧⌘C`, `⇧⌘V`) or on every page with the same number of photos, save your own layouts, a background photo with opacity per page, page margin and photo gap per page, page numbers with per-page hiding.
- **No Lightroom needed.** Any folder of JPEG, TIFF, PNG or WebP works. Capture date, star rating and caption come from EXIF/XMP/IPTC.
- **Print-ready PDF for the printer you choose.** Interior as single pages or as spreads (one PDF page per double page, as Saal Digital wants), cover as one sheet with back, spine and front. Bleed, TrimBox/BleedBox, CMYK with an ICC output intent (e.g. FOGRA39) or sRGB, resampling to the target resolution and output sharpening. The spine width follows from page count and paper: from the printer's published formula (KDP, Lulu), its table (Lulu hardcover), the cover template you download from the printer, or the value you enter. The PDF is written page by page, so a 500-page book does not need gigabytes of memory.
- **Preflight before you pay.** Empty frames, low resolution, missing print files, photos in the glue zone, page count limits per printer and paper, an estimated spine width, spine text on too thin a book and the wrong colour space are checked before export.
- **Ask your AI to lay it out.** Billerbook ships an MCP server with 35 tools, so an assistant can do everything the app does, including choosing the print shop and paper, importing the cover template, duplicating pages and copying layouts. Claude, Codex, Cursor or any other MCP client can create a project from a folder, fill pages, look at each spread as an image, fix what looks off, run preflight and export. Changes appear live in the app.
- | | |
- |---|---|
- |  |  |
- |  |  |
- ## Print shops
- Billerbook writes standard print PDFs, so it works with any print shop that accepts PDF uploads. Print profiles hold what differs between shops: page sizes, bleed, single pages or spreads, page count rules, the spine rule per paper and the cover measurements.
- | Print shop | Region | Profile |
- |---|---|---|
- | WIRmachenDRUCK | DE · AT · CH | verified against data sheets and printed books |
- | Amazon KDP | worldwide | paperback verified (published spine formula), hardcover via KDP template |
- | Lulu | worldwide | paperback verified, hardcover spine table; casewrap via Lulu template |
- | Blurb (PDF to Book) | worldwide | interior rules verified, cover via Blurb template |
- | IngramSpark | worldwide | case laminate wrap and hinge verified, spine via template |
- | Mixam | UK · US · DE · AU · CA | cover measurements verified, spine from the cart |
- | Saal Digital Professional Line | EU · UK · US | spreads, blank first and last page, sRGB; cover via template |
- | PrestoPhoto | US · worldwide | interior rules verified, cover via template |
- | Custom | any | every value editable, export and share as a profile |
- Any other print shop: download its cover template and import it, or enter its numbers once and export them as a profile. See [docs/print-profiles.md](docs/print-profiles.md) for the fields and sources.
- ## Install
- **Mac:** download the DMG for Apple silicon or Intel from [Releases](https://github.com/tillheidrich/billerbook/releases/latest). The app is signed and updates itself. Until Apple has notarized a release, open it the first time with right-click › *Open* (or allow it under System Settings › Privacy & Security).
- **From source (macOS, Linux, Windows):** Node.js 22.13 or newer.
- ```bash
- git clone https://github.com/tillheidrich/billerbook.git
- cd billerbook
- npm install
- npm start # opens http://localhost:4580
- ```
- Projects live in `~/Library/Application Support/Billerbook` on macOS (`~/.billerbook` on Linux, `%APPDATA%\Billerbook` on Windows). Set `BILLERBOOK_DATA` to change it.
- ## Workflow with Lightroom Classic
- 1. Put the photos for the book into a collection.
- 2. In Billerbook: **Sources** → choose the catalog → tick the collection.
- 3. For printing, export that collection from Lightroom as full-size JPEG or TIFF into one folder (file names like the originals) and set it as the **export folder**. Until then Billerbook shows Lightroom's previews and preflight lists the photos without a print file.
- 4. Optional: import a book you already made in Lightroom's Book module as a new edition.
- ## Keyboard
- | Key | Action |
- |---|---|
- | ← → | previous / next spread |
- | Space | next arrangement for the photos on the page |
- | F | fill frame ⇄ whole photo |
- | V | photo as full-bleed page |
- | 1 – 9 | layout with that many photos |
- | A | auto grid |
- | N | new page after |
- | + / − | zoom inside the frame |
- | Del | remove photo |
- | Alt + drag | move a free frame |
- | ⌘D | duplicate page or spread |
- | ⇧⌘C / ⇧⌘V | copy layout / paste layout on this page |
- | ⌘Z / ⇧⌘Z | undo / redo |
- ## Lightroom plug-in
- *File › Install Lightroom Classic Plug-in…* in the Mac app (or the button in *Sources*) copies the plug-in into Lightroom's Modules folder. After restarting Lightroom Classic you find, in the Collections panel:
- - **Billerbook › your project › Hardcover**: the photos in that edition
- - **Billerbook › your project › Hardcover – missing**: photos from the project's Lightroom collections that are not in it yet
- The plug-in updates them every 20 seconds while Billerbook is open (switch this off in the Plug-in Manager), or on demand with *Library › Plug-in Extras › Sync book collections now*. It only creates and fills these collections. Source: [`lightroom/Billerbook.lrplugin`](lightroom/Billerbook.lrplugin).
- ## AI / MCP
- ```json
- {
- "mcpServers": {
- "billerbook": {
- "command": "/Applications/Billerbook.app/Contents/MacOS/Billerbook",
- "args": ["/Applications/Billerbook.app/Contents/Resources/app/mcp.mjs"],
- "env": { "ELECTRON_RUN_AS_NODE": "1" }
- }
- }
- }
- ```
- From source use `"command": "node", "args": ["/path/to/billerbook/mcp.mjs"]`. The app shows the exact entry under **?**. Details and example prompts: [docs/mcp.md](docs/mcp.md).
- ## Development
- ```bash
- npm test # end-to-end: folder → layout → PDF (needs poppler-utils and qpdf for the checks)
- npm run app # run the Electron app from source
- npm run dist:mac # signed + notarized DMGs (see scripts/build-mac.sh)
- ```
- The shared core in `public/lib/` (geometry, layouts, operations, print profiles, translations) runs in the browser, the server and the MCP server alike. `lib/` holds the Lightroom reader, photo pool and thumbnails, the streaming PDF writer and the preview renderer. See [CONTRIBUTING.md](CONTRIBUTING.md).
- How Billerbook compares to Lightroom's Book module, BookWright, CEWE, Saal Digital, Mixbook and others, and which of their rules we adopted: [docs/competitors.md](docs/competitors.md).
- ## License
- AGPL-3.0. You can use, change and share Billerbook freely. If you offer a modified version as a service, its source code has to be available too.
- Demo photos in the screenshots: Till Heidrich.
- ---
- ## Deutsch
- Billerbook ist ein quelloffenes Werkzeug für Fotobücher. Aus einem Bilderpool entstehen mehrere Ausgaben desselben Buchs, etwa ein dickes Hardcover quer und ein kürzeres Softcover hoch für die Verwandtschaft. An jedem Foto sieht man, in welchem Buch es steckt. Der Filter „Fehlen hier“ zeigt, was noch fehlt.
- Lightroom Classic ist optional: Billerbook liest Sammlungen, Vorschauen und Bildunterschriften aus dem Katalog und übernimmt Bücher aus dem Buch-Modul. Ohne Lightroom reicht ein Bilderordner. Am Ende steht ein druckfertiges PDF mit Beschnitt, CMYK und Umschlag samt Rücken, für jede Druckerei, die PDF annimmt. Das Profil für WIRmachenDRUCK ist gegen deren Datenblätter geprüft.
- Die Oberfläche gibt es auf Deutsch und Englisch. Download für den Mac unter [Releases](https://github.com/tillheidrich/billerbook/releases/latest), die App aktualisiert sich selbst.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.