pi-jingle
Play sounds on pi events like agent_start and agent_end
Package details
Install pi-jingle from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-jingle- Package
pi-jingle- Version
1.1.1- Published
- Apr 25, 2026
- Downloads
- 846/mo · 846/wk
- Author
- gitmonke
- License
- unknown
- Types
- extension
- Size
- 74 KB
- Dependencies
- 0 dependencies · 0 peers
Pi manifest JSON
{
"extensions": [
"./jingle.ts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
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