Skip to content

Releases: kaiser62/TS3AudioBot

Latest master build

Latest master build Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 17 Oct 06:26

Automatic build of master at 08f4a8c (bot version 0.12.28-kaiser.1+1.08f4a8c4). Not a stable release; it is replaced on every push to master.

TS3AudioBot 0.12.28 — kaiser62 edition

Choose a tag to compare

@github-actions github-actions released this 17 Oct 10:46

kaiser62 edition of TS3AudioBot, a fork of Splamy/TS3AudioBot for feeding TeamSpeak music bots straight from YouTube and Spotify.

What's new since v0.12.11-kaiser.1

  • Searches that find nothing get a second chance. When YouTube returns no results for a search first query (common for long Spotify queries such as Game, Artist - Title lyrics explicit), the bot retries with looser versions of it: without trailing words like lyrics explicit, without bracketed parts, then with just one of the listed artists. This works for every sender.
  • Searches with apostrophes work. deploy/youtube-dl passes arguments to yt-dlp safely, so titles like There's No Moonlight This Night no longer fail, and a search can no longer run commands in the container.
  • YouTube userscript 1.4.0. The Play/Queue buttons sit in YouTube's like/share row and look like YouTube's own, with a ▾ menu to pick the bot. Hover buttons on thumbnails are icon-only and follow the thumbnail.
  • Spotify extension: if a search with the suffix finds nothing, the plain search is tried.
  • Web interface icons are now included in the package (they were missing before).
  • Stops a stray ObjectDisposedException error appearing in the log after some yt-dlp runs.
  • Automatic builds. Every push to master is built and tested by CI and published as the master-latest prerelease. deploy/autodeploy.sh with its systemd timer can keep a server on it: it waits for the songs playing now to end, swaps in the new build and rolls back if the bots don't reconnect.

What's inside

  • TS3AudioBot-0.12.28-kaiser.1-linux-x64.tar.gz: self-contained Linux x64 bot with the web interface and the deploy/ scripts.
    • Public web API with per-user !api token auth, anonymous-remote blocking and Cloudflare-aware IPs.
    • Session-free search first play|add commands.
    • YouTube via yt-dlp in Docker, with cookies, a cache and auto-update; range-chunked googlevideo downloads (no 403s).
    • Better audio format choice, readable yt-dlp errors, optional per-channel step log.
  • ts3audiobot.user.js: YouTube userscript (Tampermonkey/Violentmonkey). Play or queue the current video, or tick songs in Mixes and playlists and queue them in one go.
  • ts3audiobot.js: Spicetify extension. Right-click tracks, albums, playlists, Liked Songs or artists in Spotify; each track plays from its best YouTube match.

Setup

See the Quick start in the README. Upgrading from v0.12.11-kaiser.1: replace the TS3AudioBot binary, the WebInterface folder and your youtube-dl wrapper with the ones from the tarball.

Known issues

  • YouTube live streams don't play. They are skipped by design via skip=hls.
  • Linux x64 only. Build other platforms from source.

Checksums

See SHA256SUMS.txt.

Licensed under OSL-3.0, like upstream. All credit for the base bot goes to Splamy and the TS3AudioBot contributors.

TS3AudioBot 0.12.11 — kaiser62 edition

Choose a tag to compare

@kaiser62 kaiser62 released this 14 Oct 11:27

First release of the kaiser62 edition of TS3AudioBot, a fork of Splamy/TS3AudioBot for feeding TeamSpeak music bots straight from YouTube and Spotify.

What's inside

  • YouTube userscript 1.4.0 (ts3audiobot.user.js)
    • Play or queue the current video from buttons next to Like and Share that look like YouTube's own, with a ▾ menu to pick the bot.
    • Tick songs in Mixes and playlists and queue them in one go, with live progress, a reason for each song that fails, and Try again.
    • Looks native in YouTube's light and dark themes.
  • Spotify extension (ts3audiobot.js, Spicetify)
    • Right-click tracks, albums, playlists, Liked Songs or artists in the Spotify app.
    • Each track plays from its best YouTube match. lyrics explicit is added to each search by default, to prefer plain audio and uncensored versions; if that finds nothing, the plain search is tried.
  • Bot (TS3AudioBot-0.12.11-kaiser.1-linux-x64.tar.gz, binary reports 0.12.28): self-contained Linux x64 build with the web interface and the deploy/ scripts.
    • A public web API with per-user !api token auth, anonymous-remote blocking and Cloudflare-aware IPs.
    • Session-free search first play|add commands.
    • YouTube via yt-dlp in Docker, with cookies, a cache and auto-update.
    • Range-chunked googlevideo downloads, so no more 403s.
    • Better audio format choice and readable yt-dlp errors.
    • An optional per-channel step log.

Setup

See the Quick start in the README. In short:

  1. Run the bot and set up the deploy/ scripts.
  2. Enable [web.api] with allow_anonymous_remote = false.
  3. Publish only /api/* over HTTPS.
  4. Users install a sender and connect it with their TeamSpeak unique ID and the token from !api token.

Known issues

  • YouTube live streams don't play. They are skipped by design via skip=hls.
  • Linux x64 only. Build other platforms from source.

Updates

  • 2026-10-15: assets refreshed. Userscript 1.4.0; the Spotify extension retries a search without the suffix when it finds nothing; deploy/youtube-dl in the tarball now passes arguments safely, so searches with apostrophes work and can no longer run commands in the container. Update an existing install by replacing your youtube-dl wrapper with the one from the tarball.

  • 2026-10-17: bot binary rebuilt from master (0.12.28). When a search first query finds nothing on YouTube, the bot now retries with looser versions of it: without trailing words like lyrics explicit, without bracketed parts, then with just one of the listed artists. This works for every sender. Also stops a stray ObjectDisposedException error appearing in the log after some yt-dlp runs. Update by replacing the TS3AudioBot binary.

Checksums

See SHA256SUMS.txt.

Licensed under OSL-3.0, like upstream. All credit for the base bot goes to Splamy and the TS3AudioBot contributors.