43502018c5
+Add options +Add help +Add support for multiple identical devices *New README *Bug fixes
42 lines
905 B
Markdown
42 lines
905 B
Markdown
# zmidimap
|
|
|
|
Map midi signals coming from ALSA midi devices to shell commands
|
|
|
|
Soft dependencies: alsa-utils
|
|
Hard dependencies: aseqdump
|
|
|
|
## Installing
|
|
|
|
### Package
|
|
|
|
#### Debian/Ubuntu
|
|
Download the .deb package then run: `sudo dpkg -i zmidimap.deb ; sudo apt -f install`
|
|
|
|
### Standalone
|
|
|
|
Move executable `zmidimap` to your PATH directory
|
|
|
|
### From source
|
|
|
|
```sh
|
|
git clone https://github.com/zawwz/zmidimap.git
|
|
cd zmidimap
|
|
make && sudo make install
|
|
```
|
|
|
|
## 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`
|