How do I install the Audio Playback skill?

Run npx skillmds add sonilo-ai/audio-playback in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Audio Playback safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Audio Playback?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Audio Playback free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Audio Playback?

sonilo-ai (@sonilo-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Audio Playback by sonilo-ai — Agent Skill

Name: Audio Playback
Rating: 4.2 (5 reviews)
Author: sonilo-ai

Audio Playback

Play a local audio file through the system's default speakers using Sonilo's MCP server. Use after generating a track with Sonilo (or for any local WAV/MP3/M4A/AAC/OGG/FLAC file) when the user wants to hear it immediately instead of just getting the saved path.

sonilo-ai d666f8b 2.7 KB Updated Sep 9, 2026

File contents

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

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

Parameters

Parameter	Type	Notes
`input_file_path`	string	Absolute 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).

---name: audio-playbackdescription: Play a local audio file through the system's default speakers using Sonilo's MCP server. Use after generating a track with Sonilo (or for any local WAV/MP3/M4A/AAC/OGG/FLAC file) when the user wants to hear it immediately instead of just getting the saved path.license: MIT--- # 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](../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 | Tool | Description | |------|-------------| | `play_audio(input_file_path)` | Play a local audio file through the system's default speakers. | ## Parameters | Parameter | Type | Notes | |-----------|------|-------| | `input_file_path` | string | Absolute 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).

Frequently asked questions