Skip to content
[object Object] BOOKSCANNER

How Aglaïa works

Aglaïa turns a stack of photographed or scanned book pages into a clean, searchable document. Every page travels the same four-stage path, and the whole journey is recorded in a single project file you can reopen, branch, and replay.

flowchart LR
    Import["IMPORT<br/>images / PDF / webcam frame"]
    Pipeline["PIPELINE PROCESSING<br/>DPI · deskew · page · dewarp · binarize …"]
    OCR["OCR<br/>recognise text lines"]
    Export["EXPORT<br/>searchable PDF / Markdown"]
    AGL["one &lt;slug&gt;.agl SQLite project file<br/>(raw scans · every step · branches · OCR)"]
    Import --> Pipeline --> OCR --> Export
    Import --> AGL
    Pipeline --> AGL
    OCR --> AGL
    Export --> AGL

The four stages

  1. Import — image files, PDF pages, or live webcam frames are ingested. Each one becomes a raw scan (the untouched source image) stored in the project.
  2. Pipeline processing — every raw scan runs the ordered chain of processors defined by a pipeline YAML: DPI normalisation, deskew, page detection, page dewarp, binarisation, and so on. Each step’s output is persisted, so the chain can branch (e.g. a two-page spread splits into two pages) and replay.
  3. OCR — an OCR engine reads the chosen output of each page into text lines (and, for some engines, structure such as headings and tables). This runs off the pipeline, on the image the user selected for each page.
  4. Export — the chosen page outputs are assembled into a searchable PDF (image + invisible OCR text layer) and/or a Markdown document. You can also export a slim copy of the project itself.

One file holds everything

All four stages read and write a single .agl project file — a plain SQLite database holding the raw scans, every pipeline step, the branch choices, and the OCR results. The same file (and the same pipeline) drives both the capture GUI and headless CLI batches, so an interactive scan and a scripted run produce identical results.

Comparison: GUI vs headless

Capture GUIHeadless CLI
Entryaglaia.py <dir>aglaia.py <inputs> --headless
Importlive webcam + import panelimage / PDF / .agl arguments
Processingidentical IntegratedProcessingChainidentical
OCR / exporttabs + buttons--do-ocr / --export flags
Use whenscanning interactivelybatching, automation