parch
Yearly planner PDFs for e-ink, a Python port of Vitaliy Kudryk’s LYP.
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
Nineteen 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 |
ipad-mini |
iPad mini. No toolbar (Scribe pack). Alias mini |
ipad-air-11 |
iPad Air 11. No toolbar (Scribe pack). Aliases ipad, air-11 |
ipad-pro-11 |
iPad Pro 11. No toolbar (Scribe pack). Alias pro-11 |
ipad-pro-13 |
iPad Pro 13. No toolbar (Scribe pack). Alias pro-13 |
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 (four paper×hand permutations each) 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. Hero planner PDFs (device × paper × hand) attach from release-pdfs.yml (not Pages, not a PyPI gate).
License
MIT. See LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for parch 0.2.13
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| parch-0.2.13.tar.gz | 193.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| parch-0.2.13-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 301.7 kB
Release files / parch-0.2.13.tar.gz
| Download URL | parch-0.2.13.tar.gz |
|---|---|
| Size | 193.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
97026df4c1236154580bc9c2756b1332afff182a2165a6f2a007ae103261b052
|
|
BLAKE2b-256 checksum How to use checksums |
cfdc13c7785343a0bd765b07340d83054251064a4329abf4f331587042b87f5e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 6, 2026.
Transparency logRelease files / parch-0.2.13-py3-none-any.whl
| Download URL | parch-0.2.13-py3-none-any.whl |
|---|---|
| Size | 108.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fb91f0a48673c830977fedddd2f5b400f6eef0ce5b874c6c339e4e0957c5fe7c
|
|
BLAKE2b-256 checksum How to use checksums |
3cc60e64409ff57d4ea72f526f5e02e2caa117af86f59b95083b1c65691b48f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 6, 2026.
Transparency log
