[proxy] github.com← back | site home | direct (HTTPS) ↗ | proxy home | ◑ dark◐ light

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

vustagc

Skip to content

Navigation Menu

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Sign up

Folders and files

NameName

Last commit message

Last commit date

Latest commit

History

8 Commits

pianoterm

Run shell commands from your piano

Description

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

Usage

pianoterm <port>

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)