music

Tasks for publishing my music.

The code is idiosyncratic with my music project conventions and therefore applicable mainly to me. However, the code may be a useful example for using Reaper's Python API.

Prerequisites

1. A Python install with framework. For example, with pyenv:

   PYTHON_CONFIGURE_OPTS="--enable-framework" pyenv install <VERSION>

2. SWS Extension

Install

1. pip install .

2. Open Reaper
3. Configure Reaper for Python (per reapy's README)

   python -c "import reapy; reapy.configure_reaper()"

4. Restart Reaper

Usage

music --help

For example:

music render

Which renders the current project in Reaper, with terminal output like the following.

Contribute

Install for local development:

pip install --editable '.[testing]'
pre-commit install

Tests

pytest

Besides tests, checks are run on commit, after installing the pre-commit hook above, and on push. You can also run them manually.

pre-commit run --all-files

Debug

When using breakpoint(), you'll probably want to disable rich output, via the TERM=dumb environment variable. That will make the Python interactive debugger easier to see.