txt2musicxml 0.1.0

CLI tool to convert chords written in simple text to musicxml files that can be used with a music notation software

txt2musicxml

A simple tool to convert chords from text to musicxml. Musicxml files can be opened with most notation software (for example MuseScore, which is free and opensource).

Usage

pipe a string of chords into the cli

echo 'Cmaj7 A7 | Dm9 G7b913 |' | txt2musicxml

or redirect input/output from/to a file

txt2musicxml < path/to/Thriller.crd > path/to/Thriller.musicxml

Syntax Example

Aguas de Marco - Elis Regina & Tom Jobim:

Bb/Ab | Bb/Ab |
Bb/Ab | Gm6 Cm7b5/Gb |
Bbmaj7/F E9b5 | Ebmaj9 Ab9 |
Bbmaj7 Bb7 | C7/E Ebm6 |
Bbmaj7/F Bb7 | C7/E Ebm6 |

More info in SYNTAX.md

Developing Locally

Dependencies

In order to change the grammer and regenerate lexer/parser/etc:

• java
• antlr

For other development:

• python (3.13)
  • I suggest using pyenv to manage multiple python versions on your machine
• poetry - to manage virtual env
• Make - to help run useful commands

Updating and Debuging

Grammer is defined in txt2musicxml/grammer/Chords.g4. To generate antlr python classes (Lexer, Parser, Visitor, Listener) from the grammer file, run:

antlr4 -Dlanguage=Python3 txt2musicxml/grammer/Chords.g4 -visitor

Those classes are direct dependecies of the application, they must exist for the main program to run.