A DJ sound pad for the CLI that turns your OS system sounds into music. Press keys to trigger sounds, record loops, and play built-in demo beats.

Works on macOS and Windows. No audio libraries or external dependencies required.

gh extension install dvelton/gh-dj-pad

Or build from source:

git clone https://github.com/dvelton/gh-dj-pad.git
cd gh-dj-pad
go build -o gh-dj-pad .
./gh-dj-pad

gh dj-pad             # launch the pad
gh dj-pad --demo 1    # auto-play a demo pattern
gh dj-pad --bpm 140   # set tempo

  1=Basso    2=Funk    3=Tink    4=Pop
  Q=Sosumi   W=Bottle  E=Morse   R=Frog
  A=Glass    S=Ping    D=Hero    F=Blow
  Z=Purr     X=Sub     C=Frog+   V=Basso+

Three built-in patterns to try:

1. Notification Groove -- Four-on-the-floor beat using Basso, Tink, Funk, and Pop
2. System Alert -- Syncopated groove with Morse and Frog accents
3. Startup Sequence -- Melodic pattern with Hero, Ping, Glass, and Bottle

Press P to cycle through them, or launch directly with --demo 1.

On macOS, sounds play via afplay using the built-in system sounds from /System/Library/Sounds/. On Windows, sounds play via PowerShell using WAV files from C:\Windows\Media\. Each sound fires in its own goroutine so multiple sounds layer naturally.

The loop recorder captures your key presses with millisecond timing and plays them back on repeat, quantized to the current BPM.

MIT