mcpField
A
audio-playback

audio-playback

github.com/sonilo-aiCreative & media11771 installsUpdated 1d ago
Repository

About audio-playback

Sonilo’s audio-playback skill plays local audio through the system’s default output device, for example after generating a file. Playback is local and makes no network calls.

Key features

  1. 01Play local audio files
  2. 02Use the default output device
  3. 03Support multiple audio formats
  4. 04Restrict file access paths

Use cases

  1. 01Listen to newly generated audio
  2. 02Play audio from a specified path

MCP support

The Sonilo MCP server exposes the `play_audio` tool, which accepts a local file path and plays the audio.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sonilo-ai/skills --skill audio-playback

After installing, type/audio-playbackin Claude Code to confirm it loaded.

Details

From the project README

Sonilo Audio Playback

Play a local audio file out loud through the system's default output device. This is the one Sonilo tool that makes no network call — it's pure local playback, useful right after a generation so the user can hear the result without leaving the conversation.

Setup: just needs the Sonilo MCP server connected — no API key required (see setup-api-key if the server itself isn't connected yet).

Quick Start

MCP tool call
play_audio(input_file_path="~/Desktop/thunder.m4a")

There is no REST, Python/JS SDK, or CLI equivalent — this is local-only playback specific to the MCP server, not a Sonilo API call at all. If you're integrating via the SDK or CLI instead of MCP, just play the saved file with whatever your own language/platform normally uses for local audio playback.

Tool

ToolDescription
play_audio(input_file_path)Play a local audio file through the system's default speakers.

Parameters

ParameterTypeNotes
input_file_pathstringAbsolute path, or relative to SONILO_MCP_BASE_PATH. Supports .wav/.mp3/.m4a/.aac/.ogg/.flac.

Workflow Tips

  • Natural follow-up after any generation tool. Once text_to_music, text_to_sfx, video_to_music, etc. return a saved path, offer (or default, if the user's phrasing implies it — e.g. "play what you just made") to call play_audio on that same path.
  • Platform playback path: macOS uses afplay; Linux prefers mpg123 for .mp3 or aplay otherwise. Windows has no native-player branch at all and always falls back to the sounddevice/soundfile Python packages, same as Linux when neither mpg123 nor aplay is installed — that fallback needs the system PortAudio library installed separately (brew install portaudio on macOS, sudo apt-get install libportaudio2 on Debian/Ubuntu). Everything else in this repo works without PortAudio.
  • Respects the same file-access confinement as every other tool: a path outside SONILO_MCP_BASE_PATH is rejected unless SONILO_MCP_ALLOW_ANY_PATH=true is set.

Error Handling

Raises if the file doesn't exist, isn't a recognized audio format, is outside the confined base path, or if no player is available on the platform (with a message naming what's missing).

Comments

Markdown supported