Add music bot for self-hosted Stoat with web control panel

Plays audio into Stoat voice channels over LiveKit and exposes the same
player through both chat commands and a browser panel, so the two never
drift apart: everything routes through a single MusicManager.

- core: per-server GuildPlayer (queue, loop, shuffle, seek, volume,
  idle auto-leave) driving revoice.js/@livekit/rtc-node and ffmpeg
- sources: yt-dlp for YouTube/SoundCloud, direct media URLs and internet
  radio, optional local library with path-traversal guards
- bot: 18 chat commands with aliases, plus !panel one-time login links
- api: Fastify REST + WebSocket, sessions authenticated against the
  instance's own /auth/session/login (TOTP supported), permissions
  re-checked against Stoat membership and roles on every request
- web: React panel with search, queue editing, seek and volume
- deploy: Dockerfile, compose.override.yml and Caddyfile snippets for
  dropping the service into an existing /opt/stoat stack

Verified with npm run typecheck, both builds, and scripts/smoke-api.mjs
(9 API checks). Voice playback itself needs a live instance to test.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

This commit is contained in:

Leonid Pershin

2026-09-08 23:12:43 +03:00

co-authored by

Claude Opus 5

parent d9d0e9f6bf

commit a9b7ccdd16

43 changed files with 12436 additions and 0 deletions

									
										web/index.html
									
		+13
		
												View File
												
				@@ -0,0 +1,13 @@

				<!doctype html>

				<html lang="ru">

				  <head>

				    <meta charset="UTF-8" />

				    <meta name="viewport" content="width=device-width, initial-scale=1.0" />

				    <meta name="color-scheme" content="dark" />

				    <title>Stoat Music</title>

				  </head>

				  <body>

				    <div id="root"></div>

				    <script type="module" src="/src/main.tsx"></script>

				  </body>

				</html>