Skip to main content

gendisc

Python versions PyPI - Version GitHub tag (with filter) License GitHub commits since latest release (by SemVer including pre-releases) CodeQL QA Tests Coverage Status Dependabot Documentation Status mypy uv pytest Ruff Downloads Stargazers pre-commit Prettier

@Tatsh Buy Me A Coffee Libera.Chat Mastodon Follow Patreon

Generate disk file path lists for mkisofs.

Installation

Pip

pip install gendisc

Usage

Usage: gendisc [OPTIONS] PATH

  Make a file listing filling up discs.

Options:
  --cross-fs                   Allow crossing file systems.
  -D, --drive FILE             Drive path.
  -d, --debug                  Enable debug logging.
  -i, --starting-index INDEX   Index to start with (defaults to 1).  [x>=1]
  -o, --output-dir DIRECTORY   Output directory. Will be created if it does
                               not exist.
  -p, --prefix TEXT            Prefix for volume ID and files.
  -r, --delete                 Unlink instead of sending to trash.
  --no-labels                  Do not create labels.
  --cd-write-speed INTEGER     CD-R write speed.
  --dvd-write-speed INTEGER    DVD-R write speed.
  --dvd-dl-write-speed FLOAT   DVD-R DL write speed.
  --bd-write-speed INTEGER     BD-R write speed.
  --bd-dl-write-speed INTEGER  BD-R DL write speed.
  --bd-tl-write-speed INTEGER  BD-R TL write speed.
  --bd-xl-write-speed INTEGER  BD-R XL write speed.
  --preparer TEXT              Preparer string (128 characters).
  --publisher TEXT             Publisher string (128 characters).
  -h, --help                   Show this message and exit.

The output is a series of shell scripts (1 for each disc) that do the following:

  • Generate the ISO image with mkisofs for the current set.
  • Save a SHA256 sum of the image for verification.
  • Save a tree listing for later use (tree must be installed).
  • Save a file listing via find for later use.
  • Requests to insert a blank disc.
  • Uses cdrecord to burn.
  • Ejects and re-inserts the disc.
  • Verifies the disc.
  • Deletes the source files or sends them to the bin.
  • Ejects the disc.
  • Requests to move the disc to a label printer.
  • If you have GIMP installed, open it to the printer dialogue.

If you have mogrify (ImageMagick) and Inkscape installed, a label will be generated. This can be then opened in a tool that can have your printer (such as an Epson XP-7100) print to disc (GIMP). The image should be ready for printing (under Image Settings you should see it is exactly 12 cm at DPI 600).

Many of the steps above can be skipped by passing flags to the script. Currently the script supports these options:

Usage: script.sh [-h] [-G] [-K] [-k] [-O] [-P] [-s] [-S] [-V]
All flags default to no.
  -h: Show this help message.
  -G: Do not open GIMP on completion (if label file exists).
  -K: Keep ISO image after burning.
  -O: Only create ISO image.
  -P: Open GIMP in normal mode instead of batch mode.
  -S: Skip ejecting tray for blank disc (assume already inserted).
  -V: Skip verification of burnt disc.
  -k: Keep source files after burning.
  -s: Skip clean-up of .directory files.

Metadata

Release files for gendisc 0.1.1

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

Source distribution (sdist)

Source distribution for gendisc 0.1.1
File Size Uploaded Provenance Actions
gendisc-0.1.1.tar.gz 32.3 kB With provenance Details for gendisc-0.1.1.tar.gz

Built distribution (wheel)

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

Total release size: 57.6 kB

Release files / gendisc-0.1.1.tar.gz

Download URL gendisc-0.1.1.tar.gz
Size 32.3 kB
Tags Source
SHA-256 checksum
How to use checksums
27cb9831bcdaa39ef4f1e9e02c6c5e50ccbabe4d93b886befe333bd401cbde71
BLAKE2b-256 checksum
How to use checksums
f67fe1c3906bdadf23d407fae0929541ccd4de7a119b6351bb149b81f4336178
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 May 8, 2026.

Transparency log

Release files / gendisc-0.1.1-py3-none-any.whl

Download URL gendisc-0.1.1-py3-none-any.whl
Size 25.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9e2e34a7ad9e175c73514d0d2463c11c61e94c86b7f28bd0413ae4748d6eed4c
BLAKE2b-256 checksum
How to use checksums
350f98a99749042c673b323811571010ed7db95b21fa546d01cb38dabe8e26ee
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 May 8, 2026.

Transparency log

Security for gendisc 0.1.1

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.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for gendisc-0.1.1.tar.gz

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 May 8, 2026.

Transparency log

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