# 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`