zmidimap/README.md
2020-03-03 10:25:14 +01:00

41 lines
907 B
Markdown

# zmidimap
Map midi signals coming from ALSA midi devices to shell commands
Dependencies: alsa-utils
## Installing
### Package
#### Debian/Ubuntu
Download the .deb package then run: `sudo dpkg -i zmidimap.deb ; sudo apt -f install`
### Standalone
Download ``zmidimap.tar.gz`` for a standalone executable
### From source
Depends on: [ztd](https://github.com/zawwz/ztd)
``make -j6`` for a shared build
``STATIC=true make -j6`` for a static build
## Usage
`zmidimap [options] <map file>`
This is a daemon program, it does not start any background process by itself and needs to be constantly running for the mapping to be active
## Map File / Configuration
See `example.mim` for an example file
For more details see `zmidimap --help`
## Options
To scan for devices use `zmidimap -l`
To scan a device's inputs use `zmidimap -p <client name>`
For more details see `zmidimap --help`