pi-jingle

Play sounds on pi events.

pi install npm:pi-jingle

Configuration

Add to ~/.pi/agent/settings.json:

{
  "sounds": {
    "agent_end": "/path/to/done.mp3",
    "when_coding": "/path/to/music.mp3"
  }
}

Path formats:

• /absolute/path.mp3 - absolute path
• ~/sounds/file.mp3 - resolves to ~/.pi/sounds/file.mp3
• ./sounds/file.mp3 - resolves to ~/.pi/sounds/file.mp3

Volume: Use an object for volume control (0.0 - 1.0):

{
  "sounds": {
    "agent_end": { "path": "/path/to/sound.mp3", "volume": 0.5 }
  }
}

Supported Events

Event	Description
agent_start	Task begins
agent_end	Task completes
session_start	pi starts
session_shutdown	pi closes
turn_start	User message received
turn_end	Response sent
tool_call	Tool execution
tool_result	Tool result received

Default: Plays done.mp3 on agent_end if no config exists.

when_coding: Loops a song from agent_start until agent_end.

Commands

• /sounds list - Show configured sounds
• /sounds reload - Reload config

Requirements

Sound player for your platform:

• macOS: afplay (built-in) or ffplay
• Linux: paplay, aplay, or ffplay
• Windows: PowerShell (built-in)

Install ffplay for volume control: brew install ffplay