miredis/README.md

74 lines
1.5 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"
2020-10-02 21:33:24 +00:00
All events are forwarded to a redis server and an OSC server.
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
2020-10-09 12:57:03 +00:00
## New Features
2020-10-05 11:54:25 +00:00
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
/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"