bifurc2midi 0.0.1

This application generates midi bifurcation diagrams generated from generated logistic map data.

bifurc2midi

This application generates midi bifurcation diagrams generated from generated logistic map data.

See instructions for installation on macOS for more detailed guide on getting started.

Installation

• Prerequisites:
  • Python 3
  • pip

Make sure pip is up to date:

python3 -m pip install --upgrade pip

• Install package from source code:

pip install .

• Now you can run the application from the command line e.g.

bifurc2midi --version

Usage

• For help:

bifurc2midi --help

• Run with default settings:

bifurc2midi

This will generate a midi file in the current working directory.

• Sending midi output to a specific device:

bifurc2midi --midi-out-device device_name

Where device_name is the name of the midi device you want to send the output to. Use a device name of 'default' to use the first available device e.g.

bifurc2midi --midi-out-device 'device_name'

• Enabling midi loopback driver on macOS (e.g. for use with DAWS):
  1. Open 'Audio MIDI Setup.app'
  2. Click 'Window' -> 'Show MIDI Studio'
  3. Double click 'IAC Driver' device
  4. Check 'Device is online' checkbox
  5. Click 'Apply'
  6. Make sure 'IAC Driver' enabled as a midi input device in your DAW

Development

• Pre-requisites:

  • Python 3
  • pip
  • virtualenv

• Use the Makefile for local development:

1. Activate a virtual environment:

make virtualenv

2. Activate the virtual environment (not strictly necessary, if using the Makefile only):

source venv/bin/activate

3. Install dependencies:

make install

Then you can:

• Run the application:

make run

Extra arguments can be passed by providing EXTRA_ARGS variable e.g.

make run EXTRA_ARGS="--help"

• Run tests:

make test

• Run linter:

make lint

make fmt can be used to automatically fix some linting errors.

• Other useful make targets are provided too, see the Makefile for details. Or run make/make help

TODO

• Investigate improving blending of note transitions/overlaps
• Add tests, replace the placeholder test
• Run tests in github actions
• Release as a package
• Review what is settings/parameters are configurable
• Installation shell script
• Add support to specify the starting note
• GUI
• Realtime parameter tweaking as it sends midi to output