Skip to content

Command line application and functions to generate midi sequences from Henon maps

License

Notifications You must be signed in to change notification settings

jjsymes/henon2midi

Repository files navigation

henon2midi

This application generates midi output and midi files from Henon map data.

Installation

  • Install from PyPI:
pip3 install henon2midi

Usage

  • For help:
henon2midi --help
  • Run with default settings:
henon2midi

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

  • Sending midi output to a specific device:
henon2midi --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.

henon2midi --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

Installation from source

  • 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.
henon2midi --version

Development

  • Pre-requisites:

    • Python 3
    • pip
    • virtualenv
  • Use the Makefile for local development:

  1. Activate a virtual environment:
make virtualenv
  1. Activate the virtual environment (not strictly necessary, if using the Makefile only):
source venv/bin/activate
  1. 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

About

Command line application and functions to generate midi sequences from Henon maps

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published