Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mhhollomon/oscapplauncherservice
Small Open Sound Control server to launch application in response to OSC commands.
https://github.com/mhhollomon/oscapplauncherservice
c-plus-plus c-plus-plus-17 midi midi-controller osc windows
Last synced: about 1 month ago
JSON representation
Small Open Sound Control server to launch application in response to OSC commands.
- Host: GitHub
- URL: https://github.com/mhhollomon/oscapplauncherservice
- Owner: mhhollomon
- Created: 2022-05-01T23:35:45.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-01-07T13:53:25.000Z (about 1 year ago)
- Last Synced: 2024-04-17T17:12:20.400Z (10 months ago)
- Topics: c-plus-plus, c-plus-plus-17, midi, midi-controller, osc, windows
- Language: C++
- Homepage:
- Size: 104 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# OSC Application Launcher Service
Small [Open Sound Control](https://opensoundcontrol.org) server to launch applications in response to OSC commands.
This was conceived as a "helper" of sorts to [Open Stage Control](https://github.com/jean-emmanuel/open-stage-control) to allow
me to not only control my DAW but also start it using OSC.
It will most likely grow well beyond that.
## V0.4.0 Changes
- In OALMidi2osc, add the ability for an action to set the OSC address. This allows each individual action
associated with a controller to go to a different OSC server if needed.
- Support calling Powershell scripts (or really anything Windows knows how to run) in OALServer rather than just
executables.
## V0.3.0 Changes
- Addition of the OALMidi2osc server (see below).
- Fixes for OALServer when dealing with args to the new process on Windows.
## V0.2.0 Changes
- ported to linux.
- Changed format and name of OALServer config file.
- Handle int32, string, and blob parameters in OSC messages.
- allow passing a single string parameter to the launched application.
## OALServer
The server application.
Reads an configuration file from:
- Windows = `%USER_PROFILE%\\Documents\\OALServer.cfg`
- Linux = `$HOME/.oal/OALServer.cfg`
```
server: {
port = 7777
}
launch : {
notepad = "C:\\Program Files\\Notepad++\\notepad++.exe"
reaper = "C:\\Program Files\\REAPER (x64)\\reaper.exe"
}
```
Listens on 127.0.0.1:{port} for UDP Datagrams. If `port` is not given in the ini file, it defaults to 8888.
if the path in the datagram is `/launch/{appkey}`, it will run the program listed for `appkey` in the ini file.
if the path in the datagram is `/exit`, it will shutdown.
Otherwise it does nothing.
If the OSC message has at least one parameter and the first parameter is a string, that string is
passed to the application as its first command line parameter (argv[1]).
- Only listens to UDP
- Currently, only listens to localhost interface.
- Only one argument can be sent to the application.
- Does not handle OSC bundles.
- Only int32, string, and blob arguments are handled.
## OALMidi2osc
_ONLY *WINDOWS* FOR THE MOMENT_.
Server that can listen to some number of midi ports and output OSC message based on configured midi events.
```
OALMidi2osc
```
`` is optional. If not given, it uses `%USER_PROFILE%\\Documents\\OALMidi2osc.cfg`.
Sample Config :
```
// List of OSC addresses. Note that "udp" is the only transport currently supported.
osc = {
// 'oal' will be the name of the port in the map section
oal = {
address = "127.0.0.1:7777"
// optional - defaults to "udp"
transport = "udp"
}
}
// The default OSC port to send messages to. Can be overridden in the `map`
default_osc = "oal"
// List of midi ports.
midi = {
// Handy alias that will be used in error messages.
nanopad = {
// The actual midi port to monitor for events.
in = "nanoPAD2 PAD"
// Where to send any OSC messages generated.
// This overrides any global default.
osc = "oal"
// List of events to map to OSC messages. Other events will
// be silently dropped.
// Note that this is a list. If an event potentially matches
// multiple entries, the first one found will be used.
map = (
{
// details of the midi event. Possible variants are:
// cmd = "noteon" (note=ii) (vel=ii) -- note can either be a midi note number or note name(with octave)
// cmd = "noteoff" (note=ii) (vel=ii) -- note can either be a midi note number or note name(with octave)
// cmd = "cc" (num=ii) (value=ii)
// cmd = "prog" (num=ii)
// if a parameter isn't mentioned it is not used for matching.
// so, in this example a noteon for note 33 will trigger the action regardless of the velocity.
// Note that there is currently no way to tie this to a channel.
//
cmd = "noteon"; note=33;
// details of the OSC message to send
// Where to send can be given in the action in the addr key, or default via the osc tag about or
// defaulted by the global default_osc key.
// Currently only one arg can be defined. The OSC type will be deduced from the config type.
//
action : { type: "osc", addr = "oal", path="/launch/daw", arg = "arg1" }
},
)
}
}
```
## OALSend
Small utility to send OSC messages via UDP on `127.0.0.1:`. The port and OSC path are given on the command line.
One parameter can be added to the message by appending it to the command line. The type indicator is put before the data.
```
# send message with string parameter.
OSCSend.exe 7777 /launch/notepad "s:random text"
#send message with int32 parameter
OSCSend.exe 777 /launch/notepad i:42
```
## Integrating with Open Stage Control
Add the 127.0.0.1:{port} to the `osc` property of the widget.
Add the path (e.g. `/launch/notepad`) to the `path` property of the widget.
## Tech Used
* [libconfig](https://github.com/hyperrealm/libconfig) for configuration parsing.
## References
* [Open Sound Control](https://opensoundcontrol.org/)
* [Open Stage Control](https://github.com/jean-emmanuel/open-stage-control)
* [Midiview](https://hautetechnique.com/midi/midiview/) - spy on midi messages in the system on windows.
* [loopMIDI](https://www.tobias-erichsen.de/software/loopmidi.html) - create virual MIDI ports on windows.
* [Midiio](http://midiio.sapp.org/) - nice library for midi io - didn't use it, but learned a lot reverse engineering it.