Metadata-Version: 2.4
Name: chordpro-pdf
Version: 0.1.2
Summary: Convert ChordPro files to PDF music sheets with ukulele chord diagrams
Author-email: Baiju Muthukadan <baiju.m.mail@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/baijum/chordpro
Project-URL: Repository, https://github.com/baijum/chordpro
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Sound/Audio
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: parsimonious>=0.10.0
Requires-Dist: reportlab>=4.0
Dynamic: license-file

# ChordPro

A Python tool that converts [ChordPro](https://www.chordpro.org/) files to PDF music sheets with ukulele chord diagrams.

## Features

- Parses standard ChordPro format (`.cho`, `.chordpro`)
- Renders PDF with lyrics, inline chord names, and 4-string ukulele chord diagrams
- Supports verses, choruses, tabs, and chorus recall
- Custom chord definitions with fret and finger positions (GCEA tuning)
- Metadata directives: title, subtitle, artist, key, tempo, time, capo
- Letter and A4 page sizes

## Installation

```bash
pip install chordpro-pdf
```

Requires Python 3.8+.

## Usage

```bash
chordpro input.cho -o output.pdf
```

### Options

| Flag | Description |
|------|-------------|
| `-o`, `--output` | Output PDF path (defaults to `input.pdf`) |
| `--page-size` | `a4` (default) or `letter` |

## ChordPro Format

```
{title: Amazing Grace}
{key: G}

{define: G base-fret 1 frets 0 2 3 2 fingers 0 1 3 2}
{define: C base-fret 1 frets 0 0 0 3 fingers 0 0 0 3}

{start_of_chorus: Chorus}
A[G]mazing [C]grace, how [G]sweet the sound
{end_of_chorus}
```

Chords are placed inline using `[ChordName]` notation. See [`sample.cho`](chordpro/sample.cho) for a complete example.

## License

MIT
