miredis/README.md

79 lines
1.7 KiB
Markdown
Raw Normal View History

2020-10-02 21:33:24 +00:00
# Forward Midi events to redis/OSC
Miredis hooks to all midi devices connected and listen for events.
2020-10-06 18:03:48 +00:00
Miredis can optionnaly hook to opensourced Link protocol (200+ music & videos apps) -> "/beat" & "/bpm"
2021-09-23 02:03:08 +00:00
All events are forwarded to your redis server and your OSC server.
2020-10-02 21:33:24 +00:00
2021-04-10 13:21:26 +00:00
2020-10-25 14:52:56 +00:00
![Clitools](https://www.teamlaser.fr/images/miredispad.png)
2021-04-10 13:21:26 +00:00
Run (not with python 3.9)
2020-10-02 21:33:24 +00:00
python3 miredis.py
2020-10-05 11:54:25 +00:00
See options :
python3 miredis.py -h
2020-10-06 18:03:48 +00:00
To enable Link :
python3 miredis.py -link
2021-09-23 02:03:08 +00:00
(for cheap midi interface midisport/midiman from audio on Linux : apt-get install midisport-firmware)
2020-10-09 12:57:03 +00:00
## New Features
2020-10-05 11:54:25 +00:00
2021-09-23 02:03:08 +00:00
- Client example : midicontrol.py
2020-10-09 12:57:03 +00:00
- Added verbose mode -v
- Added redis subscribe events
2020-10-25 14:52:56 +00:00
- Added Clitools program selection mode for Launchpads
2021-04-10 13:21:26 +00:00
- Added custom redis 'key event', to be more semantic/hardware agnostic with Configuration file : miredis.json. i.e "/feedback/1/114/value" is generated each time a CC message on channel 1, CC 114 is recevied.
2020-10-06 13:37:34 +00:00
2020-10-06 18:03:48 +00:00
2020-10-02 21:33:24 +00:00
## OSC
2021-09-23 02:03:08 +00:00
Following messages will be sent to an outside OSC server :
2020-10-02 21:33:24 +00:00
/midi/noteon midichannel note velocity
2020-10-02 21:34:39 +00:00
2020-10-02 21:33:24 +00:00
/midi/noteoff midichannel note
2020-10-02 21:34:39 +00:00
2020-10-02 21:33:24 +00:00
/midi/cc midichannel ccnumber value
2020-10-02 21:34:39 +00:00
2020-10-02 21:33:24 +00:00
/midi/clock
2020-10-02 21:34:39 +00:00
2020-10-02 21:33:24 +00:00
/midi/start
2020-10-02 21:34:39 +00:00
2020-10-06 13:37:34 +00:00
/midi/stop
2020-10-06 18:03:48 +00:00
/beat beatnumber
2020-10-06 13:37:34 +00:00
/bpm bpm
2020-10-09 12:57:03 +00:00
2021-04-10 13:21:26 +00:00
/Your custom (see configuration file). Ex : /feedback midichannel ccnumber value
2020-10-09 12:57:03 +00:00
## Redis keys
"/midi/noteon/midichannel" value : "note/velocity"
"/midi/noteoff/midichannel" value : "note"
"/midi/cc/midichannel/ccnumber" value : "ccvalue"
"/beat" value : "beatnumber"
"/bpm" value : "currentbpm"
2021-04-10 13:21:26 +00:00
custom ones
2020-10-09 12:57:03 +00:00
2020-10-09 16:29:24 +00:00
## Redis : midi events published to "/midi/last_event"
2020-10-09 12:57:03 +00:00
"/midi/noteon/midichannel/note/velocity"
"/midi/noteoff/midichannel/note
"/midi/cc/midichannel/ccnumber/ccvalue"
2021-04-10 13:21:26 +00:00
customs one like "/feedback/1/114/value"