abcforge 0.1.0

CLI pipeline: Guitar Pro / MusicXML → ABC → interleaved ABC

abcforge

CLI pipeline for converting music notation through the full stack:

Guitar Pro / MusicXML  →  ABC  →  interleaved ABC

Install

pip install abcforge
# or run without installing:
uvx abcforge --help

Commands

abcforge gp2xml   <input_dir> <output_dir>   # .gp/.gpx/.gp5 → .musicxml  (requires MuseScore)
abcforge xml2abc  <input_dir> <output_dir>   # .musicxml → .abc
abcforge abc2abci <input_dir> <output_dir>   # .abc → interleaved .abc
abcforge view     <file>                     # open .abc or .musicxml in browser

All batch commands accept --workers N (default: cpu count) and --log <path> (errors to file instead of stderr).

Viewer

abcforge view opens files at abcviewer.sven.zone. Supports both ABC notation and MusicXML — the viewer auto-detects the format and renders MusicXML via OpenSheetMusicDisplay.

abcforge view song.abc
abcforge view song.musicxml
abcforge view song.abc --url     # print URL only, don't open browser

Notes

• MusicXML → ABC conversion uses xml2abc by W.G. Vree (LGPL).
• The vendored abctoolkit is a patched fork of abctoolkit 0.0.6 with fixes for voice attribute parsing and bar splitting. Do not replace it with the PyPI version.
• MuseScore must be installed for gp2xml.