A commandline musical step-sequencer with some advanced features.
Make sure you have Python installed
Choose as install method, pip or git (pip is recommended if you have it)
pip install pystepseq
Either download from the 'dist' directory here, or:
git clone https://github.com/akjmicro/pystepseq
Once downloaded, in the 'pystepseq' directory:
python setup.py install
Files will be installed into a Python lib directory on your system. E.G., on a Linux system, something like
You may also want to edit the variables at the top of the 'constants.py' These will reflect what MIDI port you are using (e.g., on Linux, '/dev/snd/midiC1D0') and also the multicast port you will be broadcasting the metronome on (and the listeners listening on). Default is 8123.
- YOU NEED TO SETUP YOUR COMPUTER FOR MULTICASTING VIA LOOPBACK.
Here's how it's done on Linux (I don't know about anywhere else, sorry):
route add -net 188.8.131.52 netmask 240.0.0.0 dev lo
IF YOU DON'T DO THE ABOVE STEP, NO MIDI NOTES WILL BE TRIGGERED! The metronome (tempotrigger.py) is dependant on the network multicasting for functionality.
- YOU NEED TO MAKE SURE YOUR MIDI INSTRUMENTS ARE RECEIVING.
Of course, set up your software (or hardware) synths to be listening on the same MIDI port you have set up pystepseq to push MIDI messages to. It is beyond the scope of this help to show you how to do that, since all synths differ. But as an example, you might set qjackctl to take the output of a virtual MIDI port (e.g. '/dev/snd/midiC1D0', which will show up in a tool like qjackctl as 'Virtual Raw Midi 1-0') and patch it to the MIDI input of the synth/sampler of your choice.
You should be fine simply starting the script and using the online help.
To start pystepseq, do the following from the commandline:
You will see a prompt:
pystepseq('h' for help)-->
This will create a new voice called 'a' if you type what is after the prompt:
pystepseq('h' for help)--> =a
This will start 'a' playing after a brief pause until the clock is lined up to a certain beat start:
pystepseq('h' for help)--> a/
This will stop 'a' playing after all its current cycle is exhausted:
pystepseq('h' for help)--> a\
The online help will give you a hang of the rest of the commands. The system is designed to be succint, in that all the commands have been designed to minimize typing, and are usually a single character, or two-character mnemonic. So for instance, "Take voice 'a' and randomize its volume sequence" would be:
pystepseq('h' for help)--> arv
...which stands for " 'a' random volumes "
Much more sense will be had once you play with it via the online help.
Aaron Krister Johnson
Please report bugs and successes to email@example.com