# songleaf

> Dense, readable one-page song sheets (lyrics + chords + score snippets) from searchable sources


## Pages in this subsection

- [songleaf](songleaf.html.md): songleaf: dense, readable one-page song sheets from searchable sources.
- [songleaf.chordpro](songleaf.chordpro.html.md): Parse ChordPro text into a `Song`.
- [songleaf.datasets](songleaf.datasets.html.md): Where the `datasets` data kind lives: local files by default, S3 by configuration.
- [songleaf.diagrams](songleaf.diagrams.html.md): Chord diagrams for the sheet: piano keys or guitar shapes (songleaf#13).
- [songleaf.engrave](songleaf.engrave.html.md): Score snippets engraved by Verovio: the `score` extra (`pip install songleaf[score]`).
- [songleaf.export](songleaf.export.html.md): Export a song as ChordPro or as plain text (chords over lyrics), transposition applied.
- [songleaf.harmony](songleaf.harmony.html.md): What a chord does in its song’s key, so that sheets can shade chords by function.
- [songleaf.importers](songleaf.importers.html.md): Turn pasted text into a `Song`: a registry of format importers.
- [songleaf.kaggle_index](songleaf.kaggle_index.html.md): A search index of the Kaggle corpus: the same songs and keys, without the corpus in memory.
- [songleaf.library](songleaf.library.html.md): The library’s lists: which stored songs are in which lists, shared by everyone using it.
- [songleaf.match](songleaf.match.html.md): Where a query matched: the words it shares with a field, as spans to highlight, and the lyric line.
- [songleaf.model](songleaf.model.html.md): The linked-artifact model: a song is lyrics text plus standoff annotations.
- [songleaf.packing](songleaf.packing.html.md): Line packing: which consecutive lines of a paragraph share a row.
- [songleaf.parse](songleaf.parse.html.md): Parse chords-over-lyrics text into a `Song`.
- [songleaf.render](songleaf.render.html.md): Render a song onto one dense page, with the lyrics as large as will fit.
- [songleaf.snippets](songleaf.snippets.html.md): Score snippets on the sheet (songleaf#12): which stretch of a song, and a small staff for it.
- [songleaf.songbook](songleaf.songbook.html.md): A songbook: several songs in one PDF, with a table of contents, page numbers and bookmarks.
- [songleaf.sources](songleaf.sources.html.md): Where songs are found: sources, and a search that composes them.
- [songleaf.store](songleaf.store.html.md): Where songs persist: a `MutableMapping` of songs, JSON files by default.
- [songleaf.timing](songleaf.timing.html.md): Play-along: a song’s media links and line timings (songleaf#30).
- [songleaf.tools](songleaf.tools.html.md): The single source of truth for every surface: plain functions, flat arguments, JSON-ready results.
- [songleaf.ultimate_guitar](songleaf.ultimate_guitar.html.md): Ultimate Guitar: community chord charts the reader opened themselves (songleaf#28).
- [songleaf.viewed](songleaf.viewed.html.md): Each viewer’s *Viewed* list: the songs they opened, the most recent first.

## Optional

- [Top-level llms.txt](../llms.txt): Complete documentation index.