Skip to main content

pylibcue is a CUE sheet parser library for python. It provides fast and reliable CUE sheets parsing interfaces for python by wrapping libcue C library with Cython.

Note: since v0.2.1, pylibcue uses libcue fork with custom patches (Cycloctane/libcue) instead of original libcue to provide additional bugfixes and features.

Install

pip install pylibcue

Compile from source

Requirements: bison, flex, make.

Clone the repo with --recurse-submodules argument.

pip install --upgrade setuptools Cython build
make test
make

Usage

Create a CD instance by parsing a CUE sheet file or string:

import pylibcue

cd = pylibcue.parse_file("./example.cue", encoding="utf-8")
# or
cd = pylibcue.parse_str("...")

Extract CD metadata and iterate through tracks in CD:

print("Title:", cd.cdtext.title)
print("Artist:", cd.cdtext.performer)
print("Date:", cd.rem.date)
print("Tracks:")

for tr in cd:
    print(f"TRACK {tr.track_number:02d}: {tr.cdtext.title} - {tr.cdtext.performer}")

cueprint

pylibcue also provides a command line tool cueprint.py to dump all information from CUE sheet. (python version of cuetools cueprint and cuebreakpoints)

Use cueprint.py to see how many fields pylibcue can extract from CUE sheet:

cueprint.py ./example.cue
# or
python3 -m pylibcue.cueprint ./example.cue

License

pylibcue is licensed under the GNU General Public License v2.0.

Release files for pylibcue 0.5.2

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

Source distribution (sdist)

Source distribution for pylibcue 0.5.2
File Size Uploaded
pylibcue-0.5.2.tar.gz 71.6 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for pylibcue 0.5.2
File Interpreter ABI Platform
pylibcue-0.5.2-cp310-abi3-win_amd64.whl CPython 3.10 abi3 Windows x86-64 Details
pylibcue-0.5.2-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl CPython 3.10 abi3 Linux glibc 2.17+ x86-64 Details
pylibcue-0.5.2-cp310-abi3-macosx_10_15_universal2.whl CPython 3.10 abi3 macOS 10.15+ universal2 (ARM64, x86-64) Details

Total release size: 370.4 kB

Release files / pylibcue-0.5.2.tar.gz

Download URL pylibcue-0.5.2.tar.gz
Size 71.6 kB
Tags Source
SHA-256 checksum
How to use checksums
c46f5b2202190ab86c1366200d9c9943493d582c31c710bdfee5e5348e960389
BLAKE2b-256 checksum
How to use checksums
1ce6dc13dd5d9707e12e27420d7b45543b5ed21fcd409457ac215bc5ac886ebc
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 Aug 8, 2026.

Transparency log

Release files / pylibcue-0.5.2-cp310-abi3-win_amd64.whl

Download URL pylibcue-0.5.2-cp310-abi3-win_amd64.whl
Size 74.1 kB
Tags CPython 3.10 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
700b0a1ac3c8eecf4daf5415f86d45269476d3ab168c4428fa49e4e6b852eb44
BLAKE2b-256 checksum
How to use checksums
6c90ecd4a4a4c92504dc2f20e1bf20e167bbc5662060cbeeabf82ccc0d2b52bb
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 Aug 8, 2026.

Transparency log

Release files / pylibcue-0.5.2-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL pylibcue-0.5.2-cp310-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 93.6 kB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
89e63493d2ad768e129b541bbe56115ea6f0ba56ae9e298c6ecb56cabc5a1dd3
BLAKE2b-256 checksum
How to use checksums
a47e8ea2cc23a5d873627a927ba1cb7e42bfc371834fe21b1fc326b6845360e4
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 Aug 8, 2026.

Transparency log

Release files / pylibcue-0.5.2-cp310-abi3-macosx_10_15_universal2.whl

Download URL pylibcue-0.5.2-cp310-abi3-macosx_10_15_universal2.whl
Size 131.2 kB
Tags CPython 3.10 abi3 macOS 10.15+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
84ad3aa5b7a608f01169821a7c1adea54736dfbfd57cec5af778c216ed430484
BLAKE2b-256 checksum
How to use checksums
3b16609ef90d6d2094f24b11bc2f3529357eebb562cfdb8213c887fb53475b5e
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 Aug 8, 2026.

Transparency log

Release history Release notifications | RSS feed

This release

0.5.2 This release

4 release files

0.5.1

16 release files

0.4.0

16 release files

0.3.0

13 release files

0.2.1

13 release files

0.2.0

11 release 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