Skip to main content

Hymns

Compile a single PDF containing all the hymns in the collection “Hymns for Home and Church”.

Using this tool

You do not need to download the source code repository to use this tool. The recommended way to use this tool is to run it through uv. Install uv on your computer and then run:

uvx hymns

This will perform the following actions:

  1. Download PDF files for all hymns into a folder named .local/cache in the current directory.
  2. Add hymn numbers to the first page of each hymn, in the correct corner.
  3. Arrange all hymns into a single PDF file.
  4. Add blank pages if necessary to keep two-page hymns in a single spread.
  5. Write the combined PDF file to hymns-eng-letter.pdf in the current directory. If hymns-eng-letter.pdf already exists, it will be overwritten.

The resulting PDF is designed to be printed double-sided.

Downloaded files

Any files that need to be downloaded to generate the final PDF will be saved in a directory named .local/cache inside the current directory. If files already exist in the cache folder, they will not be downloaded again.

You can safely delete this folder and everything in it. The next time you use this tool, the files will be downloaded again.

Alternate languages and paper sizes

The default language is English. The default paper size is Letter (8.5 x 11 inches).

You can specify a different language or a different paper size by using --lang or --size when you run the tool:

> uvx hymns --lang spa --size a4
# or abbreviated:
> uvx hymns -l spa -s a4

Currently supported languages are:

  • eng: English
  • fra: French
  • por: Portuguese (Brazil)
  • spa: Spanish

Currently supported paper sizes are:

  • letter: 8.5 x 11 inches
  • a4: 210 x 297 mm

You can generate all possible combinations of language and paper size by running:

> uvx --from hymns gen-all-hymns

Updating a printed copy

If you already have a printed copy of a previous version, you only need to print added or changed pages to update your copy.

2024.5 → 2024.9

  • Print pages 1–2 to replace pages 1–2 in your existing copy.
  • Print pages 17–36 to replace pages 17–18 in your existing copy.

2024.9 → 2025.2

  • Print pages 1–2 to replace pages 1–2 in your existing copy.
  • Print pages 35–60 to replace pages 35–36 in your existing copy.
  • Print pages 67–69 to insert at the end of your existing copy.

2025.2 → 2025.6

  • Print pages 1–2 to replace pages 1–2 in your existing copy.
  • Print pages 55–70 to replace pages 55–58 in your existing copy.
  • Print page 83 to insert at the end of your existing copy.

2025.6 → 2025.9

  • Print pages 1–2 to replace pages 1–2 in your existing copy.
  • Print pages 71–84 to insert after page 70 in your existing copy.
  • Print pages 95–99 to replace pages 81–83 in your existing copy.

2025.9 → 2026.2

  • Print pages 1–2 to replace pages 1–2 in your existing copy.
  • Print pages 83–102 to replace pages 83–84 in your existing copy.
  • Print page 119 to insert at the end of your existing copy.

2026.2 → 2026.7

  • Print pages 1–2 to replace pages 1–2 in your existing copy.
  • Print pages 99–116 to replace pages 99–102 in your existing copy.

2026.7 → 2026.10

  • Print pages 1–2 to replace pages 1–2 in your existing copy.
  • Print pages 117‐126 to insert after page 116 in your existing copy.
  • Print pages 141–145 to replace pages 131–133 in your existing copy.

Metadata

Release files for hymns 2026.10.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hymns 2026.10.0
File Size Uploaded Provenance Actions
hymns-2026.10.0.tar.gz 19.5 kB Without provenance Details for hymns-2026.10.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for hymns 2026.10.0
File Interpreter ABI Platform Actions
hymns-2026.10.0-py3-none-any.whl Python 3 none any Details for hymns-2026.10.0-py3-none-any.whl

Total release size: 44.9 kB

Release files / hymns-2026.10.0.tar.gz

Download URL hymns-2026.10.0.tar.gz
Size 19.5 kB
Tags Source
SHA-256 checksum
How to use checksums
67e70aff6d0aec65c4a9e0234e90d614d6f1fc08f0860a7c2815e644d472edf0
BLAKE2b-256 checksum
How to use checksums
bd0bdc80e1b2576aa892c91e6b64d1cf09c183fe227f5c3dd641c0dc156cc81e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / hymns-2026.10.0-py3-none-any.whl

Download URL hymns-2026.10.0-py3-none-any.whl
Size 25.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
631f90752785e222343bb648d9864b36d866f5d2101afa5834049cce7bf6b06a
BLAKE2b-256 checksum
How to use checksums
ba300943c43969eceae4bd10d3b51cde3dfe2b6e94ac67a1f68904f404c1f7a8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for hymns 2026.10.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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