parch

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

PyPI CI

Cover Contents January

Install

Needs uv and Python 3.12+.

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 ./out Where index.typst and index.pdf are written
-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)

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

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

Without --yes, parch new asks for starting profile, year, sections, and output path. Sections live in the profile sections list. Comment a name out to disable it.

Devices

MOS-left is the right-handed writing layout (nav opposite the writing hand). MOS-right is the left-handed writing layout.

Profile Device Writing hand
supernote-nomad SuperNote Nomad (A6 X2) right
supernote-nomad-mos-right SuperNote Nomad left
158x210-mos-left 158×210 right
158x210-mos-left-lined 158×210 lined right
158x210-mos-right 158×210 left
158x210-mos-right-lined 158×210 lined left
kindle-scribe Kindle Scribe right
kindle-scribe-mos-right Kindle Scribe left

Development

uv sync
uv run pytest

CI runs pytest and a Nomad parch press.

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 proof 158x210-mos-left --samples.

Ship steps live in Releasing.

License

MIT. See LICENSE.

Project links

Data verified by PyPI on Aug 29, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.8)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for yolk from gravatar.com yolk

Credits

Author: Joseph Chiocchi

GitHub Statistics

Data verified by PyPI on Aug 29, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (The MIT License (MIT))

Requires

Python >=3.12

Provides Extra

dev typst-native

Tags

e-ink planner supernote typst

Classifiers

Report project as malware

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.1.2.tar.gz (232.0 kB view details)

Uploaded Source

Built Distribution

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

parch-0.1.2-py3-none-any.whl (96.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: parch-0.1.2.tar.gz
  • Upload date:
  • Size: 232.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for parch-0.1.2.tar.gz
Algorithm Hash digest
SHA256 89af976f69a56055624dae39a72a3ea3142b6eef719423d8a746aa1380a886c2
MD5 4a53e0fac8e1e59b77d3692de484f814
BLAKE2b-256 ef641543cfb3a6e8a0b57dcea28564ee4e218d2e9a0d502cd95436f607a16613

See more details on using hashes here.

Provenance

The following attestation bundles were made for parch-0.1.2.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.

File details

Details for the file parch-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: parch-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 96.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for parch-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4e83f06b9221109038d8438c17b2467f6a8041c444a2f3a82206cc5bd53d0e87
MD5 f3c827777a1cf6c5b51947cac8e426f8
BLAKE2b-256 507350da71281f54c3e11a70f661869756acc14135207a618a1135f335103e72

See more details on using hashes here.

Provenance

The following attestation bundles were made for parch-0.1.2-py3-none-any.whl:

Publisher: publish.yml on yyolk/parch

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

Release history Release notifications | RSS feed

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

This release

0.1.2 This release

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page