A ChordPro parser, written in Python. https://igitar.com
Go to file
2022-04-07 21:33:34 -07:00
src/igitar Add constants 2022-04-07 21:33:34 -07:00
.gitignore Update ignores 2021-07-28 21:41:58 -07:00
LICENSE Initial commit 2021-07-24 06:33:16 +00:00
pyproject.toml Add setuptools data for building a package 2021-07-28 21:39:43 -07:00
README.rst Rename the project 2021-09-08 15:01:47 -07:00
setup.cfg Rename the project 2021-09-08 15:01:47 -07:00
setup.py Add setuptools data for building a package 2021-07-28 21:39:43 -07:00

igitar

igitar [ee-gee-tahr] isiXhosa, meaning guitar

igitar is a ChordPro parser, written in Python. The main difference between this module and other similar libraries is that igitar parses ChordPro files down to the syllable level, enabling finer-grained control of the formatted output.

Warning

This package is still in development. Only a subset of ChordPro is currently supported, and some key features are missing, like displaying song metadata.

Installation

You can use pip to install igitar:

$ pip install igitar

Example Usage

from igitar import Song

song = Song('path/to/song.chordpro')

for verse in song.verses:
    print(verse.title)

Rendering

igitar comes with two renders, HTML and Text.

from igitar.renderers.html import render

print(render(song))

Command Line Interface

igitar also ships with a built-in command line interface which will read a ChordPro file and then render it using either the text or HTML renderer.

For example:

$ igitar path/to/song.chordpro -f text -o song.txt

License

igitar is licensed under the MIT license. See the LICENSE file for more information.