pi-tuturu

Completion sound notifications for pi with selectable sound and volume.

Package details

← Back
extension

Install pi-tuturu from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-tuturu
Package
pi-tuturu
Version
0.1.2
Published
Apr 27, 2026
Downloads
388/mo · 388/wk
Author
glammm
License
MIT
Types
extension
Size
217.7 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

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