io.github.pooriaarab/viberadio-fm
Turns an agent's output into audio: narration, podcast, or music.
Que pouvez-vous faire avec io.github.pooriaarab/viberadio-fm ?
- Local speech: the default audio path disables network egress and uses the system speech runner from
@pooriaarab/vibe-core. - Recap scripts: formats milestone events; accepts
monologueorpodcaststyles andsummaryorpodcastmodes. - Library bridge: successful library
recap()appends a best-effort event for vibenotifications; CLI and MCP recaps call narration directly. - Two MCP tools:
narratespeaks text;recapbuilds and speaks an event recap.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
viberadio-fmclaude mcp add viberadio-fm -- npx -y viberadio-fm@0.2.3 mcp
{
"mcpServers": {
"viberadio-fm": {
"command": "npx",
"args": [
"-y",
"viberadio-fm@0.2.3",
"mcp"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
VibeRadio
Website · Setup · Library and MCP
VibeRadio is an open-source text-to-speech CLI and library that turns supplied text or coding-session events into local spoken narration for developers.
Install
npm install -g viberadio-fm
viberadio say "Build passed"
Requires Node.js 18 or newer and a system speech tool: macOS say, Linux espeak, or Linux spd-say.
Success: you hear “Build passed” and see a local-provider status message.
If speech is unavailable, the CLI prints the text and a setup warning, then exits successfully.
No API key or environment variables are required. The CLI does not load .env files.
Recap a session
printf '[{"kind":"tests-pass","count":12}]' | viberadio recap
printf '[{"kind":"tests-pass","count":12}]' | viberadio recap --style podcast
The second command changes the script to host-labelled dialogue. Both styles use one system voice.
You can also pass a JSON-array file: viberadio recap session.json --mode podcast.
Features and limits
- Local speech: the default audio path disables network egress and uses the system speech runner from
@pooriaarab/vibe-core. - Recap scripts: formats milestone events; accepts
monologueorpodcaststyles andsummaryorpodcastmodes. - Library bridge: successful library
recap()appends a best-effort event for vibenotifications; CLI and MCP recaps call narration directly. - Two MCP tools:
narratespeaks text;recapbuilds and speaks an event recap.
text / event array -> narration script -> system speech tool -> audio
There is no automatic agent-session watcher or background start command.
Reactive music, cloud voices, distinct podcast voices, recording, visualizers, and a menubar application do not ship.
This package does not include Claude Code, Codex, or Gemini adapters; pass text or events from your workflow.
Source inspection confirms three system-tool choices through the shared runner. No physical audio output was verified for this rewrite.
Library and MCP
import { buildRecapScript, narrate, recap } from 'viberadio-fm';
console.log(buildRecapScript([{ kind: 'tests-pass', count: 12 }]));
await narrate('Build passed');
await recap([{ kind: 'task-done', message: 'Fixed login' }]);
buildRecapScript() is pure and works without speech tools. narrate() throws TtsUnavailableError when audio cannot run.
createNarrator() exposes dependency injection; TypeScript declarations ship with the package.
Configure an MCP client with:
{"mcpServers":{"viberadio":{"command":"viberadio","args":["mcp"]}}}
CLI commands: say, recap, mcp, help/--help/-h, and --version/-v.
The say command accepts --style/-s; recap also accepts --mode/-m and file or stdin input.
Set VIBERADIO_DEBUG=1 for speech-failure details.
Status and links
Version 0.2.4 is pre-1.0. Interfaces can change; this package provides no managed audio service. The repository's interactive prototype and launch video show product direction, not shipped functionality. Report an issue · Vibe Suite · MIT license
Questions fréquentes
Qu'est-ce que io.github.pooriaarab/viberadio-fm ?
Turns an agent's output into audio: narration, podcast, or music.
Comment installer io.github.pooriaarab/viberadio-fm ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add viberadio-fm -- npx -y viberadio-fm@0.2.3 mcp. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.pooriaarab/viberadio-fm ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.pooriaarab/viberadio-fm est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.pooriaarab/viberadio-fm ?
Il est publié par pooriaarab. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.