Skip to content

Repository files navigation

parch

PyPI Python 3.14+ CI License: MIT

parch generates fixed e-ink PDF pages. The MVP target is SuperNote Nomad only.

Install / Press

Needs uv and Python 3.14+.

uv sync --group dev
uv run parch press examples/nomad.toml -o out/nomad-2026.pdf
uv run parch specimen supernote-nomad -w out   # PNG catalog; click a thumb to expand in place
uv run parch proof examples/nomad.toml -o out/exp-typeramp-proof.pdf

Architecture

Device → Component (data only) → Section (build Page) → Layout (chrome + seat) → Plotter → Press
Device id size resolution notes
SuperNote Nomad supernote-nomad 118.87 × 158.5 mm 1404×1872 @ 300 PPI top toolbar 8 mm reserved; writing clearance 4 mm; root_body 8.5pt

Tests

uv run pytest
uv run ruff check src tests && uv run ruff format --check src tests

Releasing

Ship steps live in Releasing.

License / Credits

MIT — see LICENSE.

Historical inspiration: Vitaliy Kudryk’s LYP. fpdf2 Plotter rewrite; not a port of LYP sources.

Runtime dependency fpdf2 is LGPL-3.0, separate from this MIT license.

Vendored Jost (Book / Medium / Bold / Heavy) is SIL OFL 1.1 — see src/parch/fonts/LICENSE.

Releases

Packages

Used by

Contributors

Languages