txt2musicxml 0.1.1

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).

Install

pipx install txt2musicxml

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.