This package provides a Python library ly containing various Python modules to parse, manipulate or create documents in LilyPond format. A command line program ly is also provided that can be used to do various manipulations with LilyPond files.
The LilyPond format is a plain text input format that is used by the GNU music typesetter LilyPond (www.lilypond.org).
The python-ly package is Free Software, licensed under the GPL. This package is written by the Frescobaldi developers and is used extensively by the Frescobaldi project. The main author is Wilbert Berendsen.
The ly command line tool
With ly you can reformat, or re-indent LilyPond files, transpose music, translate pitch names, convert LilyPond to syntax-colored HTML, etc.
There is also experimental support for converting LilyPond to MusicXML.
Use:
ly -h
to get a full list of the features of the ly command.
Here is an example to re-indent and transpose a LilyPond file:
ly "indent; transpose c d" -o output.ly file.ly
To test the ly module from the current directory without installing, use:
python -m ly <args...>
This will behave like running the ly command when the package is installed.
The ly Python module
The ly module requires Python 3. This is a short description of some modules:
ly.slexer: generic tools to build parsers using regular expressions
ly.node: a generic list-like node object to build tree structures with
ly.document: a tokenized text document (LilyPond file)
ly.lex: a parser for LilyPond, Scheme, and other formats, using slexer
ly.music: a tree structure of the contents of a document
ly.pitch: functions for translating, transposing etc
ly.indent: indent LilyPond text
ly.reformat: format LilyPond text
ly.dom: (deprecated) tree structure to build LilyPond text from
ly.words: words for highlighting and autocompletion
ly.data: layout objects, properties, interfaces, font glyphs etc extracted from LilyPond
Documentation
The documentation is built using Sphinx and located in the doc directory. If you have Sphinx installed, you can build nicely formatted HTML documentation by typing make html in the doc directory.
You can also read the docs online at http://python-ly.readthedocs.org/.
Release files for python-ly 0.9.10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| python_ly-0.9.10.tar.gz | 265.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| python_ly-0.9.10-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 493.5 kB
Release files / python_ly-0.9.10.tar.gz
| Download URL | python_ly-0.9.10.tar.gz |
|---|---|
| Size | 265.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
18ef058b4d0fa235768b6669041174370f553d6c84eb7a4495f95bb315e0f18a
|
|
BLAKE2b-256 checksum How to use checksums |
94a2c21c90a3790612521feca435e1019eae6edc6a15084aab91b13b47a7486c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Apr 4, 2026.
Transparency logRelease files / python_ly-0.9.10-py3-none-any.whl
| Download URL | python_ly-0.9.10-py3-none-any.whl |
|---|---|
| Size | 227.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2164e705e42ebf5af511c4fd45fcc1158737bd702fd5f238420a48acd22c00f5
|
|
BLAKE2b-256 checksum How to use checksums |
4f7b5f246bbd2626340f8778a11f4074a4151c99c2eb818d1569336b2b85de24
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Apr 4, 2026.
Transparency log
