choro-abc

A collection of Choro themes notated using the ABC music notation.

License

This work is dedicated to the public domain under CC0 1.0 Universal. You can copy, modify, distribute, and use the transcriptions freely, even for commercial purposes, without asking permission.

How abctools is used in this repository

This repository uses abctools to automate the export of .raw.abc files (with configuration from .abcconfig files) into standard .abc files.

Workflow

• Source files:
  All original music notation files are stored as .raw.abc files in the source/ directory.
  Each folder may contain a .abcconfig file with ABC directives (such as %%pagewidth), which are applied to all .raw.abc files in that folder and its subfolders.
  Directives in child folders override those in parent folders, allowing for hierarchical configuration.

• Exporting:
  The build process uses the abctools export command to generate .abc files from the .raw.abc and .abcconfig files.
  The output .abc files are written to the abc/ directory, preserving the folder structure of source/.

Usage

To export all .raw.abc files to .abc files, run:

npm run build

This runs the following command (see package.json):

abctools export source/ abc/

• source/: Directory containing .raw.abc and .abcconfig files.
• abc/: Output directory for the generated .abc files.

Editing and Visualization

You can use the vscode-abc-music-editor extension in VS Code to edit, visualize, and play the Raw ABC files or the ABC files directly. This extension also supports .abcconfig files.

---

For more details on abctools, see the abctools documentation.