Domain-specific terms used throughout fotobuch. This is the authoritative definition source — all code, documentation, and communication should use these terms consistently.
Term Definition
Vault A folder on disk that holds one or more projects as a single git repository. Project A single photo book — one YAML file (photo list, layout, configuration) plus a Typst template — stored alongside other projects in a vault . Template The Typst file that defines the visual design of a project — page size, fonts, spacing, and how slots are rendered in the PDF. Photo A single image file imported into a project , belonging to exactly one photo group . Photo Group A named collection of photos , typically corresponding to a source folder. Photo Weight A numeric value on a photo that controls how much space the layout gives it relative to other photos on the same page . History The complete record of all changes to a project — stored as git commits, shared between GUI and CLI, and the basis for undo and redo .
Term Definition
Page A single double-sided spread holding one or more slots , each spread carrying its own page mode . Cover The first page (index 0) of a project , which may use a different size or layout than the inner pages. Slot A positioned, sized rectangle on a page that holds exactly one photo . Aspect Ratio The width-to-height ratio of a photo or slot . Page Mode A per-page flag: Auto lets fotobuch recalculate the slot arrangement freely; Manual locks slot positions so they are not changed during rebuild . Bleed Extra image area printed beyond the trim line, ensuring no white border appears after cutting. Margin White space kept between the content area and the page edge (inside the trim line). DPI Dots per inch — the print resolution of a rendered page in the release build .
Term Definition
Toolbar The horizontal bar at the top of the window containing buttons for all main actions. Photo Pool The panel on the left side of the window listing all imported photos available for placement . Central Panel The main canvas area in the centre of the window where pages are displayed and edited. HUD The overlay controls that appear below a page in the central panel when the pointer hovers over it — includes a rebuild button, mode toggle, and delete button. New Page Area A drop zone shown in the central panel between pages where photos can be dropped to create a new page at that position. Nav Bar The panel on the right side of the window showing miniature thumbnails of all pages for quick navigation and selection . Status Bar The bar at the bottom of the window showing the current operation state and progress messages. Thumbnail A small preview image of a page or photo , shown in the nav bar and photo pool . Zoom A scaling factor applied to the central panel view that changes how large pages appear on screen without affecting the actual layout.
Term Definition
Photo Add Importing one or more image files from disk into the photo pool of the current project . Photo Place Assigning selected photos to slots on existing pages by timestamp (use rebuild first to create the pages). Unplace Removing a photo from its slot , returning it to the photo pool as unplaced. Slot Swap Exchanging the photos in two slots ; blocked within one page when their aspect ratios differ. Slot Move Relocating a photo from one slot to a slot on a different page , or to a Manual-mode slot at an arbitrary position. Dragging Moving a photo with the mouse — left-drag from the photo pool to place , right-drag a slot in the central panel to swap or move . Rebuild Recalculating the page layout — targeted (only the selected pages , keeping photo assignments) or full (redistributing all photos from scratch). Undo / Redo Navigating backwards or forwards through the history of a project , reverting or re-applying changes one step at a time. Selection A set of pages or photos currently marked for the next action (rebuild, place, delete, etc.). Multiselection Selecting more than one page or photo at once, for example with Ctrl+Click or Shift+Click.
Term Definition
Preview A fast, screen-resolution render of a page shown in the central panel and nav bar while working. Release Build A full print-quality PDF export of the complete photo book, saved as {project-name}_final.pdf in the project folder.