PeonPing/peon-ping
Peon Ping
Peon Ping is an MCP-based sound server that plays game character voice lines and desktop notifications triggered by AI coding agent events. It functions as a multi-functional system combining desktop notifications, fitness gamification, sound pack management, and audio feedback for coding environments, all accessible through the Model Context Protocol.
The project distinguishes itself through a modular architecture that includes adapter-based IDE integration, translating events from multiple agentic IDEs into a standardized sound format. It features an animated desktop pet engine that renders sprite-based characters reacting to coding events, a config-driven sound behavior system controlling volume and category toggling, and a file-based sound pack registry managing over 160 sound packs across 14 languages. The system also provides history-based deduplication to prevent repeated voice lines, a lightweight remote audio relay for forwarding sounds from remote servers, and a push notification bridge delivering alerts to mobile devices and desktop popups.
Additional capabilities include daily fitness goal tracking with workout rep logging, sound clip previewing in the browser, custom sound pack creation through GitHub repositories, and sound and notification muting that persists across sessions. The project supports remote audio relay from SSH, devcontainer, or Codespace sessions, and displays a terminal tab status indicator with project name and task completion dots.
Features
- Sound Servers - Plays game character voice lines and desktop notifications triggered by AI coding agent events via MCP.
- Sound Trigger Servers - Exposes a play_sound function through an MCP server so AI agents can trigger voice lines directly.
- Sound Tool Servers - Triggers voice lines directly by calling a tool from any MCP-compatible client.
- Sound Pack Browsing and Switching - Lists, previews, and switches between 43+ curated sound packs from games like Warcraft and StarCraft.
- Event Translation Adapters - Translates events from various agentic IDEs into a standard sound format using pluggable adapters.
- Event Translation Adapters - Provides pluggable adapters that translate events from multiple agentic IDEs into a standardized sound format.
- Character Voice Line Playback - Plays a random voice line from a game character pack when a coding agent starts a session or finishes a task.
- Sound Pack Managers - Selects from over 160 game character sound packs and controls playback volume and category toggling.
- Sound Pack Selections - Provides a manager that selects from over 160 game character sound packs across 14 languages.
- Sound Pack Switching - Cycles through or selects from over 40 game character sound packs with random rotation or manual CLI switching.
- Alert Notification Systems - Sends audio alerts, desktop popups, and mobile push notifications when coding tasks complete or need attention.
- Custom Sound Pack Creation - Registers a GitHub repository of sound clips so anyone can install and use a custom character pack.
- Fitness Gamification Tools - Prompts users to complete daily pushup and squat goals through session reminders and mid-conversation logging.
- Sound Pack Installers - Downloads and installs new character voice packs from a community registry using a CLI command.
- Desktop Notification Bridges - Delivers alerts to mobile devices and desktop popups when the terminal is unfocused.
- Sound Pack Registries - Manages over 160 sound packs across 14 languages through a community registry with CLI-based installation.
- Desktop Pet Animations - Renders an animated orc character that reacts to coding events with sleeping, waking, and celebrating animations.
- Mobile Push Notification Deliveries - Delivers push notifications to your phone when coding tasks finish or need attention.
- Remote Audio Relays - Routes audio and desktop notifications from SSH, devcontainer, or Codespace sessions to the local machine.
- Notification Delivery Fixes - Pushes alerts when the terminal is not focused, ensuring you never miss a permission prompt.
- Audio Behavior Configurations - Controls volume, category toggles, spam thresholds, and pack rotation through a single configuration file.
- Audio Behavior Configurations - Adjusts volume, enables or disables specific sound categories, sets spam thresholds, and configures pack rotation.
- Reactive Desktop Pets - Renders a sprite-based animated character that reacts to coding events with state-driven animations.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
