• The TeamSpeak Client 3.1.10 on Linux is currently not supported. Use Client version 3.1.9 or follow our installation guide.
  • If you need help or want to discuss things, you now can also join us on our Discord Server!

TS3 SyncWatch

No permission to download
Da ich nun mit der Entwicklung recht weit vorangeschritten bin, wollte ich nun mein Ergebnis mal präsentieren:

Es ist ein Webinterface für den Sinusbot, das den Sinn hat, Youtube-Videos (die mittels !ytdl geladen wurden) gemeinsam und zeitgleich ansehen zu können.
Das Video bzw. der Player wird dazu synchron mit dem Track des Sinusbot gehalten.

Auf der Weboberfläche gibt es außerdem ein paar Controls, um den Bot zu steuern, sofern man die entsprechenden Rechte dafür vergibt, damit man nicht alles per Chat-Commands machen muss.

Alle nicht mittels !ytdl geladenen Tracks können durch einen alternativen HTML5-Webplayer gestreamt werden. Leider ohne Video, da der Sinusbot diese Information nicht mitspeichert.

Kritik, Verbesserungsvorschläge oder sonstige Anmerkungen werden immer gerne gesehen! Bugs natürlich nicht, aber bringt sie mir bitte, wenn ihr welche findet :)
Since I have progressed with the development quite far, I wanted to present my results now:

A web interface for the Sinusbot, which enables you to watch the currently playing title (has to be loaded per !ytdl) synchronized to the bot in a youtube window.
Also, there is webstream support now for audio-files not loaded via !ytdl.

You can control the bot instance via some basic buttons implemented in the UI.

Criticism, suggestions for improvement or other comments are always welcome! Bugs of course not, but bring me please if you find some :)

1. Install the script like any other by dropping the script *.js file and the folder from the archive into your sinusbot/scripts folder.

2. Create a user for the webinterface so the sinusbot-script is able to generate a token from it. This step is optional because you can use the login dialog on the webinterface.
a. Give permissions: You basically only need to give [LOGIN] permission for the script to work, but if you want to control the bot via UI you also have to allow [PLAYBACK] and [MANAGE INSTANCES]. If you specify admin credentials or a user with full permissions, you have to be careful, since advanced users could read out the token and control your bot with it (or maybe worse).


b. let your bot listen to commands if you want to use them


c. If no token is given and you try to login to the webinterface, then the webinterface will ask for username and password to store until the token invalidates or you log out.

3. Activate the script in your sinusbot script settings and configure the script settings. Save.


The custom chat message option may not be available to you yet! Just wait for a new release.

4. If you want to make use of the webstream mechanism, you have to enable it first in your sinusbot server configuration file (set 'EnableWebStream = true' in config.ini).

5. Enjoy!

Basic Usage
- Write !sw to the ts3-bot via teamspeak private message and you will get back an authenticated Link to the web interface.
- Write !swc and everyone in bot channel will get a link
Note: If that does not work, you can go also open it via your sinusbot script settings by clicking the name of the script or navigate to /scripts/syncwatch manually.

Public URL (re-)routing (optional)
If you provided a custom url via config, you will most probably need to setup your routing for it to work. I can provide you with my apache virtualhost config at least:

ProxyPass /api http://localhost:8087/api
ProxyPassReverse /api http://localhost:8087/api

ProxyPass / http://localhost:8087/scripts/syncwatch/
ProxyPassReverse / http://localhost:8087/scripts/syncwatch/

  • Media-Player that is being synchronized to the sinusbot instance
    • currently only !ytdl supported
    • WebStream-fallback for titles not found on youtube (audio only - sorry, videos are not stored by sinusbot)
  • Sidebar with bot-controls, tools and settings
    • Bot-Search
    • Play/Pause/Stop/Previous
    • Adjust/Toggle Sync Interval
    • TS3-Channel-list and possibility to navigate through and join channels (WIP)
    • Login with Username and Passwort
  • see below

You can use these chatcommands on sinusbot that listens to chatcommands via teamspeak.
  • !sw: returns a link to SyncWatch in private chat
  • !swc : posts the link in channel chat
  • !swr : reloads all scripts

- possibility to download and play new tracks via webinterface (in work)
- add support for !yt (not trivial though)
- add instance respawn buttons (start, stop bot)
- add some visitor interaction (websockets)

- teamspeak3 channel list in sidebar
- upgrade to sinusbot 0.13.37
- adjustable syncing intervals
- implement web-streaming
- moved controls to sidebar
- added overlay when in sync mode
- minified most parts for performance
- fix sync when running in background (to prevent lagging)
- improve prev play stop track control
- fix ui bugs when using controls too much
- add instance selection
- finish login
- implemented en-/disabling of some sections in certain contexts
- implemented authorization via web interface
- added dropdown for better track selection
- added an input field for playing already loaded tracks on submit
- added play, stop, prev buttons for controlling the sinusbot instance
- added currently running track info
- implemented url routing for authorization via teamspeak-link
- implemented synchronization from sinusbot (server) to youtube-player (client) for !ytdl-title
- embedded youtube player
- added seconds parameter
- added configuration parameters for username and password to be used by the script
- created sinusbot script for generating link to the youtube title running

Again, please report bugs! Thanks!

First release
Last update
4.58 star(s) 12 ratings

Latest updates

  1. login bugfix, added components to sync lifecycle

    - fixed login via webinterface - made channellist reactive, added to sync lifecycle - made...
  2. Fixed Teamspeak Chat Commands, Introduced Channel list

    - repaired the channel commands that didn't for some - upgraded the whole script to the latest...
  3. major bugfixes

    + adjustable sync interval through slideout input field (saved in local storage) + toggle...

Latest reviews

Gutes Script!
Finde die Idee und das Script super. Doch leider bekomme ich es nicht installiert. Es funktioniert immer irgendetwas nicht. Sobald ich es hinbekomme gibt es auch 5 Sterne :D
Wie kann ich helfen? Und was genau versuchst du?
LG vincolus
Works! i hope you finish !yt support soon :D
Thanks! Currently I am having lots of unfinished projects that I am also working on, but I got it working locally a few weeks earlier.
I could provide a test-release, but since I recreated almost the whole webinterface using a templating engine there are quite a few bugs left that I currently cannot care about...
Great script man. So far everyone on my server seems to get a kick out of it. maybe for the next update let use change the out going message for each command and custom them.
Hey, that's really nice to hear! What kind of messages would you like to customize? Can you give an example, please?
I really support your script and your script is the best for me
thanks, that's nice to hear! :)
Add-Youtube-Download ist ausgegraut, was kann ich tun?
Diese Funktion ist ausgegraut, weil sie mit der nächsten Version kommen sollte. Also alles normal - außer, dass es noch nicht funktioniert ;)
Gucke zusammen mit anderen in echtzeit Videos, ganz einfach und ohne Probleme. Ein großartiges Script für alle, die gerne mal zusammen mit anderen Videos gucken möchten. Einfache Installation, ein grandioses kostenloses und funktionierendes Script und schnellen Support per Nachricht vom Autor, was möchte man mehr? Watch2Gether und ähnliche Plattformen werden mit dem Script nicht mehr benötigt, alles wichtige könnt ihr ab sofort über das Script mit dem Sinusbot machen.
very good addon! :) great job
but i'm getting Sorry, but SyncWatch has insufficient permission to do this. and i give playback and login perm on bot
that's strange. do you authenticate via teamspeak? can you post more details? thanks
Cooles Script! Wenn auch Videos von Liedern, die über das Youtube Webinterface mit "Play Now" / "Enqueue", oder youtube Playlists, gestartet wurden, abgespielt werden können gibt es 5 Sterne :)
Danke! Derzeit arbeite ich an den media controls (previous track, play/pause, stop); aber ich lasse dich wissen, wenn es soweit ist ;)
Cooles Plugin. Dokumentation könnte etwas ausführlicher sein, aber wenn es einmal läuft, dann läufts :)
Danke für die Info. Woran genau hat es denn gehapert?