Skip to content

Releases

0.7.2

Choose a tag to compare

@ulaski ulaski released this 15 Nov 19:19

Added

  • A light/dark switch in the web panel's top bar. The panel still follows the system theme until you pick one, and remembers the pick in that browser.

Changed

  • Mendil and Mendil-Native are in Unraid Community Applications: the Unraid guide now installs them from the Apps tab, and adding the template by hand stays as a fallback.

Update

docker compose pull && docker compose up -d

No setting has to change.

0.7.1

Choose a tag to compare

@ulaski ulaski released this 13 Nov 16:17

Fixed

  • The web panel showed an empty page in 0.6.2 and 0.7.0. A quoting mistake in the Turkish YouTube error message stopped the panel's script from loading. A test now checks that the panel script parses.

Update

docker compose pull && docker compose up -d

No setting has to change. If you run 0.6.2 or 0.7.0, update: their web panel shows an empty page.

0.7.0

Choose a tag to compare

@ulaski ulaski released this 13 Nov 14:39

Unraid templates and a Pterodactyl egg.

Added

  • Unraid templates (examples/unraid/), for the Classic and the Native engine, with the data in appdata.
  • Pterodactyl egg (examples/pterodactyl/egg-mendil.json), with the Native engine. Pelican imports it too.
  • PUID / PGID: when the container is started as root (--user 0), Mendil hands its data folders to that user and runs as it, never as root. This is what the Unraid templates use.
  • Under Pterodactyl, Mendil keeps its data in /home/container and puts the web panel on the server's port.

Update

docker compose pull && docker compose up -d

No setting has to change.

0.6.2

Choose a tag to compare

@ulaski ulaski released this 13 Nov 13:48

A documentation site.

Added

  • Documentation site: https://ulaski.github.io/mendil/, with a landing page and searchable docs, built with Astro Starlight from site/ and published by GitHub Actions.
  • A test that fails when a setting the code reads or a chat command is missing from the docs.
  • Docs for AI assistants: every docs page has Copy page (copies it as Markdown) and View as Markdown, each page is also served at its address plus .md, and the site publishes llms.txt and llms-full.txt.

Changed

  • The README is shorter and links to the docs site for details. PANEL_HOST is now documented.
  • The chat message about YouTube blocks links to the docs site's YouTube page; docs/youtube.md points there too.

Update

docker compose pull && docker compose up -d

No setting has to change.

0.6.1

Choose a tag to compare

@ulaski ulaski released this 13 Nov 12:53

Fixed

  • Classic: after a container restart (docker restart, or Docker restarting it after an error), PulseAudio didn't start and Mendil exited again with "PulseAudio did not start". A stale pid file from the previous run made PulseAudio think it was already running.
  • Times in chat such as "1:05" showed an emoticon in the TeamSpeak 3 client, which turns ":0" into a face. Mendil now puts an invisible joiner after the colon.

Added

  • A demo GIF in the README.

Update

docker compose pull && docker compose up -d

No setting has to change. If you run the Classic engine, this update is recommended: without it, a restarted container could fail to start again.

0.6.0

Choose a tag to compare

@ulaski ulaski released this 13 Nov 12:18

Seek and move, and a limit on songs per person.

Added

  • !seek <1:30 | +30 | -10> jumps within the current track; in the web panel, click the progress bar (arrow keys work on it too). Listeners can seek their own songs, admins any song. Live streams and the radio can't be sought.
  • !move <from> <to> reorders the queue (admins).
  • MAX_QUEUE_PER_USER limits how many songs one person can have waiting. A playlist adds only as many as fit, and Mendil says how many it left out. Named admins are exempt. Off (0) by default.

Update

docker compose pull && docker compose up -d

No setting has to change.

0.5.0

Choose a tag to compare

@ulaski ulaski released this 13 Nov 11:05

Radio for when the queue is empty, and a pause while nobody is listening.

Added

  • Radio. RADIO_STATIONS lists internet radio stations and RADIO picks one. The radio plays whenever the queue is empty; a request interrupts it, and it comes back once the queue runs out. !radio shows the stations, admins switch with !radio <name or address> or !radio off, and the web panel has a station picker. The station's current song (ICY metadata) shows in !np and in the panel. Icecast/SHOUTcast MP3, AAC and Ogg streams, HLS, and .pls / .m3u links work.
  • Pause when alone (PAUSE_WHEN_ALONE, on by default). When nobody else has been in the channel for 30 seconds, Mendil pauses and stops transmitting, and it carries on when someone joins. The panel's lamp says NO LISTENERS meanwhile.

Update

docker compose pull && docker compose up -d

No setting has to change. Two things to know:

  • Mendil now pauses when it's alone in its channel. PAUSE_WHEN_ALONE=false keeps the old behaviour.
  • For the radio, add RADIO_STATIONS (and optionally RADIO) to your .env. See the README section "Radio".

0.4.0

Choose a tag to compare

@ulaski ulaski released this 13 Nov 10:30

Spotify links.

Added

  • Spotify links. !play and the panel take Spotify song, album and playlist links (also spotify.link short links). Mendil reads the song list from Spotify's public embed page, without an account or API key, and plays each song from YouTube, choosing the result whose length matches Spotify's. Songs are looked up just before they play, the next one ahead of time, so a playlist joins the queue at once and songs still follow each other without a gap.

Spotify's page lists at most about 100 songs of a playlist, MAX_PLAYLIST_ITEMS still applies, and private playlists can't be read.

Update

docker compose pull && docker compose up -d

No setting has to change.

0.3.0

Choose a tag to compare

@ulaski ulaski released this 13 Nov 10:05

Roles for admins and listeners, web panel sign-in with TeamSpeak, and a smaller native image.

Added

  • Roles. ADMIN_UIDS / ADMIN_GROUPS name the admins; everyone else is a listener. Listeners can request and search songs, see the queue, and skip or remove the songs they requested. Pause, stop, volume, loop, shuffle, clear, play-next, !join and other people's songs are for admins. Without admin lists, everyone stays an admin as before. !help lists only what you may use, and !whoami shows your role.
  • Web panel sign-in with TeamSpeak. Type your nickname, get a one-time code from Mendil in a private message, and the panel knows who you are: your role matches chat, and your requests carry your name. The panel password still works and always signs you in as an admin. Listeners don't see the log.

Changed

  • The native image uses a static ffmpeg build (wader/static-ffmpeg, pinned by digest) instead of Debian's, which brought ~400 MB of shared libraries with it. The image shrinks from 284 MB to 185 MB compressed (1.12 GB to 740 MB unpacked). The classic image keeps Debian's ffmpeg, because it plays into PulseAudio.
  • Panel sessions from 0.2.0 end after the update, because the session cookie changed: sign in again once.

Fixed

  • The native engine's "from source" instructions built an untagged image, so Compose pulled the published one instead; the README now adds a build section. .env.example no longer sets VOICE_BACKEND, which had overridden the native image's engine.

Update

docker compose pull && docker compose up -d

No setting has to change: without ADMIN_UIDS / ADMIN_GROUPS, everyone stays an admin. To give friends a listener role, see the README section "Roles". Panel users sign in again once.

🧻 Mendil 0.2.0

Choose a tag to compare

@ulaski ulaski released this 13 Nov 09:13

A web panel, and a second, experimental voice engine that works without the TeamSpeak client.

Added

  • Web panel on port 8080, laid out like a radio station's running order:
    • The current track sits under an ON AIR lamp, with the time left.
    • Every queued song shows when it will air, and the panel shows when the queue ends.
    • From the panel you can pause, skip, stop, change the volume and the loop mode, request songs by link or search, remove, shuffle and clear the queue, and read the live log.
    • It works on phones, in light and dark mode, and in English and Turkish.
    • It is protected by a password (PANEL_PASSWORD, or generated on first start). PANEL_TRUST_PROXY is for running it behind a reverse proxy. See README "Web panel".
  • Native engine (experimental): VOICE_BACKEND=native connects to TeamSpeak without the official client, through teamspeak-js. It runs on x86_64 and ARM64 (ghcr.io/ulaski/mendil:native), uses about a quarter of the memory, plays music in stereo in any channel (no Opus Music codec needed), and logs why a server refused it (wrong password, ban, security level). It raises its identity's security level when a server asks for more. Classic stays the default.
  • NATIVE_BITRATE sets the native engine's Opus bitrate.
  • CI tests the native engine end to end against TeamSpeak 3 and TeamSpeak 6 servers.

Changed

  • !search only lists playable tracks, not channels or playlists.
  • The controller is split into an engine-agnostic bot and two voice engines (src/voice/). Classic behaves as before.

Update

docker compose pull && docker compose up -d

No setting has to change. To open the web panel, publish its port. See the README section "Web panel".

Try the native engine

Use the image ghcr.io/ulaski/mendil:native, which runs on x86_64 and ARM64. The README section "With the native engine" has a compose example. The native engine keeps its own identity, so give the bot its server group again after switching. To go back, use ghcr.io/ulaski/mendil:latest.