GitHub - vustagc/pianoterm: Linux CLI tool to assign shell commands to keys on a USB MIDI Keyboard

1 min read Original article ↗

Run shell commands from your piano

Description

Linux CLI tool to assign shell commands to keys on a USB MIDI Keyboard

Usage

Note: Assumes ALSA is used as the soundcard driver Use acconnect -i to find the desired midi port

Configuration

  • $HOME/.config/pianoterm/config
# this is a comment
#
# trigger can be on_release or on_press
on_press

# syntax: port = command
# use aseqdump -p <port> to find specific keycodes

21 = playerctl previous # first key on an 88-key keyboard
22 = playerctl play-pause
23 = playerctl next
# ...
108 = /home/me/my_script.sh

Building

git clone https://github.com/vustagc/pianoterm.git
cd pianoterm && make

Dependencies

  • C compiler
  • alsactl (1.2.15.2)
  • make (optional)