parch

Yearly planner PDFs for e-ink, a Python port of Vitaliy Kudryk’s LYP.

Cover Contents January

Install

Needs uv and Python 3.14+.

uv tool install parch
parch press supernote-nomad

If typst is not on PATH, press downloads official Typst v0.15.1 into .tools/.

Press

parch press supernote-nomad

Flag	Default	Meaning
`-w` / `--workdir`	(none)	Persist `index.typst` and `index.pdf` here. Without `-w`, compile in a temp dir
`-o` / `--output`	`./<config-stem>.pdf`	Product PDF in cwd (`mine.toml` → `./mine.pdf`). With `-w` only, dest is workdir/`index.pdf`
`-l` / `--locale`	`en`	Locale code
`-g` / `--with-ghostscript`	off	Optional PDF shrink via `gs`
`--debug`	off	Draw MOS debug strokes (not a config key)
`--year`	file year	Overlay planner year (dates and cover title; not a config key)
`--hand`	profile `mos.side_menu` (or left)	MOS strip side. Overlay sets `mos.side_menu` only; well stays LTR

--year also rewrites the cover title year when the old year is in the title.

parch new --device supernote-nomad --year 2027 --yes -o mine.toml

--device is a device id. Without --yes, parch new asks for device, year, sections, MOS side, paper (dotted or lined), week rail, hours, and counts/pages, then writes a complete job file. parch edit mine.toml reopens that file. Hand-edit still loads. Sections live in the job sections list. Comment a name out to disable it.

Devices

Fifteen devices. Lined is paper (style.scratch_pad), not a device. MOS strip side is mos.side_menu (default left). Override with --hand left|right on press, proof, new, and edit. --hand does not reverse the well.

Device	Notes
`supernote-nomad`	SuperNote Nomad (A6 X2). Toolbar top 8mm
`kindle-scribe`	Kindle Scribe. No toolbar
`158x210`	158×210 mm. No toolbar
`supernote-manta`	SuperNote Manta (A5 X2). Toolbar top 8mm
`remarkable-1`	reMarkable 1. No toolbar (Scribe pack). Alias `rm1`
`remarkable-2`	reMarkable 2. Same 10.3" canvas as rM1; own name. Alias `rm2`
`remarkable-paper-pure`	reMarkable Paper Pure. Same 10.3" canvas (Carta 1300). Alias `paper-pure`
`remarkable-paper-pro`	reMarkable Paper Pro. No toolbar (Scribe pack). Alias `paper-pro`
`remarkable-paper-pro-move`	reMarkable Paper Pro Move. No toolbar (Scribe pack). Alias `paper-pro-move`
`supernote-a5`	SuperNote A5. Toolbar top 8mm (Nomad pack). Alias `a5`
`supernote-a5x`	SuperNote A5 X. Same canvas as A5; own name. Alias `a5x`
`supernote-a6`	SuperNote A6. Toolbar top 8mm (Nomad pack). Alias `a6`
`supernote-a6x`	SuperNote A6 X. Same canvas as A6; own name. Alias `a6x`
`kindle-scribe-11`	Kindle Scribe 11. No toolbar (Scribe pack). Alias `scribe-11`
`kindle-scribe-colorsoft`	Kindle Scribe Colorsoft. Same B&W canvas as Scribe 11. Alias `colorsoft`

Development

uv sync
uv run pytest

CI runs pytest and a Nomad parch press. On master, CI also runs parch specimen for the framed devices and deploys the catalog to GitHub Pages.

Experimental: compile through the PyPI typst binding instead of the CLI.

uv sync --extra typst-native
PARCH_TYPST=py uv run parch press supernote-nomad

Or uv tool install --with typst==0.15.0 parch, then PARCH_TYPST=py parch press supernote-nomad. Default is still cli. There is no auto. The binding is 0.15.0; the CLI pin is v0.15.1.

uv run pytest skips the full-book comparison (slow). Run it with uv run pytest -m slow -o addopts=.

Regenerate the thumbs above with parch specimen 158x210.

Ship steps live in Releasing.

License

MIT. See LICENSE.

Development Status
- 4 - Beta
License
- OSI Approved :: MIT License
Programming Language
Topic
- Printing

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

parch-0.2.4.tar.gz (179.3 kB view details)

Uploaded Sep 3, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

parch-0.2.4-py3-none-any.whl (105.5 kB view details)

Uploaded Sep 3, 2026 Python 3

File details

Details for the file parch-0.2.4.tar.gz.

File metadata

Download URL: parch-0.2.4.tar.gz
Upload date: Sep 3, 2026
Size: 179.3 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for parch-0.2.4.tar.gz
Algorithm	Hash digest
SHA256	`eea8fc6e273820cea2a7c70c56a859961ba699d963dfcd04d64f06d4e5c315a3`
MD5	`84f0ebc0e16aa84a9d466cbf84e25891`
BLAKE2b-256	`a0369e092c032aa72f58ba08815a6dbef990a995bbedad27acd8a28c648aaf22`

See more details on using hashes here.

Provenance

The following attestation bundles were made for parch-0.2.4.tar.gz:

Publisher: publish.yml on yyolk/parch

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: parch-0.2.4.tar.gz
- Subject digest: eea8fc6e273820cea2a7c70c56a859961ba699d963dfcd04d64f06d4e5c315a3
- Sigstore transparency entry: 2696165145
- Sigstore integration time: Sep 3, 2026
Source repository:
- Permalink: yyolk/parch@15a195722ab651d57414aaa515d2f333aff43446
- Branch / Tag: refs/tags/v0.2.4
- Owner: https://github.com/yyolk
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@15a195722ab651d57414aaa515d2f333aff43446
- Trigger Event: release