pi-tuturu

A small Pi package that plays a completion sound when the agent finishes.

It includes one bundled sound: tuturu.

Features

• Plays a sound on agent_end
• /tuturu configuration UI in Pi settings-list style
• Select sound, volume, test sound, or show config path
• Footer/dashboard status when enabled: tuturu : 60%
• random mode for custom sound collections

Install

From npm:

pi install npm:pi-tuturu

From GitHub:

pi install git:github.com/ratatulieoi/pi-tuturu

Then restart Pi or run:

/reload

Usage

Open the configuration UI:

/tuturu

Controls:

• Arrow keys: move
• Enter/Space: cycle value
• Type: search
• Esc: close

Configuration

Config file:

pi-tuturu.json

Default:

{
  "sound": "tuturu",
  "volume": 60,
  "sounds": {
    "tuturu": "sounds/tuturu.wav"
  }
}

Add more sounds

Add your files anywhere, then edit pi-tuturu.json.

Example with files inside the package:

{
  "sound": "random",
  "volume": 70,
  "sounds": {
    "tuturu": "sounds/tuturu.wav",
    "correct": "sounds/correct.wav",
    "done": "sounds/done.mp3"
  }
}

Example with absolute paths:

{
  "sound": "correct",
  "volume": 70,
  "sounds": {
    "tuturu": "sounds/tuturu.wav",
    "correct": "/home/you/Music/correct.mp3"
  }
}

If sound is random, Pi randomly picks from existing files in sounds.

If sound is off, no dashboard status is shown and no sound plays.

Platform support

• Linux: uses paplay
• macOS: uses afplay
• Windows: uses PowerShell audio playback

The bundled sound is a .wav so it works on Windows without extra dependencies.

On Linux, paplay must be available. On Arch/CachyOS it is usually provided by PulseAudio/PipeWire Pulse compatibility packages.

Check:

command -v paplay