Repository navigation
🧻 Mendil 0.1.0
First public version of 🧻 Mendil.
Playback
- YouTube links, playlists and search terms, via yt-dlp and ffmpeg.
- Chat commands: play, playnext, search/pick, skip, stop, pause/resume, now playing, queue, remove, clear, shuffle, loop, volume, join, whoami and help.
- Tracks are downloaded before they play, and the next one is fetched while the current one plays. Songs follow each other with a gap of about 0.2 s. Live streams and tracks over 30 minutes (
PREFETCH_MAX_DURATION) are streamed instead.PREFETCH=falsestreams everything. - Consistent loudness: each track is measured once and played at a fixed gain with a limiter.
- The queue, the current position, the loop mode and the volume survive restarts, crashes and updates. Playback resumes a few seconds before where it stopped.
- When tracks keep failing, playback stops and the queue is kept.
!resumeor a new!playretries.
TeamSpeak
- Works with TeamSpeak 3 and TeamSpeak 6 servers (tested with 3.13 and 6.0.0-beta13.1).
- It runs the official TeamSpeak 3 client headless (Xvfb + PulseAudio) and controls it through the ClientQuery plugin. The client is downloaded on first start once you accept its license (
TS3CLIENT_LICENSE=accept). - Recovers on its own:
- A lost connection is retried within seconds, then with backoff.
- After a kick it waits 45 s; after a ban it waits until the ban ends.
- A stuck or crashed client is restarted.
- The container restarts when nothing else helps.
- Channel self-check: Mendil posts a short hint when the channel's codec or talk power is wrong for music (
CHANNEL_HINTS). - Access control by unique ID (
ALLOWED_UIDS) or server group (ALLOWED_GROUPS).!whoamishows both. - Outgoing messages are paced to stay clear of anti-flood limits. If a block happens anyway, Mendil names the permission that fixes it.
YouTube
- YouTube blocks are recognised: Mendil explains them in chat and links to docs/youtube.md (cookies, proxy).
YTDLP_PROXYroutes YouTube traffic through a proxy.- yt-dlp updates in the background (daily, and when extraction breaks). A new version that fails a self-test is rolled back.
Running it
- One Docker image (
ghcr.io/ulaski/mendil), a quick start without cloning the repo, and a singledocker runalternative. - The Docker health check turns unhealthy while Mendil is disconnected.
- A
stats:log line every 10 minutes, and/tmp/mendil-health.jsonwith connection details. - English and Turkish chat messages (
BOT_LANGUAGE). Adding a language means translating one file.
Install
docker pull ghcr.io/ulaski/mendil:0.1.0See the Quick start.