"Where every beat finds its home, and every home becomes a stage."
SonicMesh is not just another music bot — it's an intelligent, cross-platform audio ecosystem designed for Discord communities that crave seamless music experiences. Inspired by the power of Distube.js and the versatility of multi-source streaming, SonicMesh reimagines what a music bot can be: a collaborative jukebox, a discovery engine, and a real-time audio mixer all rolled into one.
Whether you're hosting a virtual party, building a study lounge, or curating a 24/7 radio station, SonicMesh provides the infrastructure for immersive, lag-free audio experiences. It supports YouTube, Spotify, SoundCloud, Yandex Music, VKontakte, Apple Music, Discord Attachments, and any HTTP stream — all unified under a single, elegant command interface.
Think of SonicMesh as a conductor for your server's audio orchestra. Traditional bots just play songs. SonicMesh orchestrates them — with intelligent queue management, automatic source switching, and a responsive web dashboard that lets you control the vibe without leaving the conversation.
Unlike other solutions, SonicMesh treats every user as a co-DJ. The queue is democratic: anyone can suggest, vote, or schedule tracks. The result? A truly collaborative listening experience that adapts to the mood of the room.
flowchart TD
subgraph "User Layer"
A[Discord Client]
B[Web Dashboard]
C[Mobile App]
end
subgraph "SonicMesh Core"
D[Command Router]
E[Queue Manager]
F[Audio Engine]
G[Source Adapter Layer]
end
subgraph "External Sources"
H[YouTube]
I[Spotify]
J[SoundCloud]
K[Yandex Music]
L[VKontakte]
M[Apple Music]
N[HTTP Streams]
end
subgraph "AI & Analytics"
O[Recommendation Engine]
P[Mood Analyzer]
Q[Usage Statistics]
end
A --> D
B --> D
C --> D
D --> E
E --> F
F --> G
G --> H
G --> I
G --> J
G --> K
G --> L
G --> M
G --> N
F --> O
O --> P
P --> Q
SonicMesh ships with a web-based dashboard that mirrors your Discord experience. Adjust volume, skip tracks, view lyrics, and manage permissions — all from a mobile browser. The dashboard is fully responsive, works offline with cached data, and supports dark/light themes.
SonicMesh speaks your language. With built-in localization for English, Spanish, French, German, Japanese, Korean, Russian, Arabic, Hindi, and more, every command and interface element adapts automatically based on the user's Discord locale.
- Auto-reconnect on voice channel disconnects
- Intelligent rate limiting to avoid API bans
- Graceful degradation when a source is unavailable (auto-switches to next available source)
- Real-time support channel integration for bug reports and feature requests
Extensions can be added as plugins without modifying core code. Want a karaoke mode? Add the @sonicmesh/karaoke plugin. Need cross-server playlists? Install @sonicmesh/playlist-sync. The ecosystem grows with your community.
No user data is stored permanently. All session data is ephemeral and cleared after 30 minutes of inactivity. No tracking cookies. No hidden analytics. Just pure, unfiltered audio.
To personalize SonicMesh for your server, create a sonicmesh.config.yaml file:
server:
name: "CyberJams HQ"
timezone: "America/New_York"
default_volume: 65
max_queue_length: 200
allow_nsfw_tracks: false
plugins:
- name: "karaoke"
enabled: true
settings:
lyric_source: "genius"
- name: "request-voting"
enabled: true
threshold: 3 # votes needed to skip
sources:
youtube:
enabled: true
quality: "highest"
spotify:
enabled: true
client_id: "your_spotify_client_id"
client_secret: "your_spotify_secret"
apple_music:
enabled: false
ai:
mood_detection: true
recommendation_engine: true
weekly_playlist_generation: true
web_dashboard:
enabled: true
port: 3000
auth_provider: "discord_oauth"Launch SonicMesh with custom arguments for advanced control:
node sonicmesh.js --token "DISCORD_BOT_TOKEN" \
--config ./sonicmesh.config.yaml \
--log-level debug \
--max-sources 4 \
--auto-reconnect true \
--dashboard-port 3000 \
--plugin-dir ./plugins \
--cache-size 512MBFlags explained:
--auto-reconnect— automatically rejoin voice channels after a disconnect--max-sources— limit parallel source fetching (prevents rate limits)--plugin-dir— load custom plugins from a directory--cache-size— memory limit for audio caching
| OS | Support | Tested Version | Notes |
|---|---|---|---|
| 🐧 Linux | ✅ Full | Ubuntu 24.04 LTS, Debian 12, Arch Linux | Recommended for production |
| 🪟 Windows | ✅ Full | Windows 11, Windows Server 2022 | Requires Node.js 20+ and VC++ Redist |
| 🍏 macOS | ✅ Full | Sonoma 14.5, Sequoia 15.0 | Apple Silicon and Intel supported |
| 📱 Android | Android 14 (Termux) | Limited to headless mode | |
| 🍎 iOS | iOS 18 (iSH) | Experimental, no voice support | |
| 🐧 Raspberry Pi | ✅ Full | Raspberry Pi OS (Bookworm) | Requires external audio DAC for quality |
SonicMesh leverages both OpenAI's GPT-4o and Anthropic's Claude 3.5 Sonnet for advanced features:
- Natural language commands: "Play something chill for studying" → AI generates a playlist
- Lyric summarization: Summarizes complex songs into 3-line bullet points
- Mood-based transitions: Detects when the room's energy drops and suggests upbeat tracks
- Context-aware queue sorting: Understands conversational context (e.g., "after this jazz track, play more brass-heavy songs")
- Cultural sensitivity filters: Avoids offensive content by analyzing lyrics and metadata
- Weekly digest generation: Summarizes listening habits with poetic flair (e.g., "Your server discovered 47 new artists this week. The most popular genre was 'synthwave with melancholic undertones'")
Note: AI features require valid API keys set in environment variables: OPENAI_API_KEY and CLAUDE_API_KEY.
SonicMesh is optimized for discovery across search engines. Key indexing terms include:
- Discord music bot 2026 – Modern, maintained, future-proof
- multi-source audio streaming – YouTube + Spotify + SoundCloud + Apple Music + Yandex + VK
- collaborative playlist management – Queue voting, scheduling, cross-server sync
- intelligent audio controller – AI-driven recommendations and mood detection
- open source Discord audio player – Built on MIT license, community-driven
- real-time audio visualizer – Built-in waveform display for web dashboard
These terms naturally appear throughout our documentation without keyword stuffing — ensuring SonicMesh ranks high while reading naturally.
SonicMesh is released under the MIT License. You are free to use, modify, and distribute this software for any purpose, provided you include the original license notice.
Full license text can be found in the LICENSE file.
SonicMesh is provided "as is" without warranty of any kind. The developers make no guarantees about:
- Content availability – Third-party sources (YouTube, Spotify, etc.) may change their terms of service or API endpoints at any time. SonicMesh cannot guarantee uninterrupted access to any external source.
- Copyright compliance – Users are responsible for ensuring they have the right to stream any content through SonicMesh. The tool does not encourage or facilitate copyright infringement.
- Voice channel stability – Discord's voice infrastructure can experience outages. SonicMesh will attempt reconnection, but cannot guarantee 100% uptime.
- AI-generated content – Recommendations and summaries from OpenAI/Claude may occasionally produce unexpected results. Always review AI output before broadcasting to a large audience.
- Data privacy – While SonicMesh minimizes data retention, any data passing through third-party APIs (OpenAI, Claude, Discord) is subject to their respective privacy policies.
By using SonicMesh, you agree to these terms and acknowledge that the developers are not liable for any damages arising from its use. This is a community project — contribute responsibly.
Built with ❤️ for the open source community in 2026. Because music should connect us, not constrain us.