ts3-adwaita-theme

Ein dunkler Stil und ein passendes Iconpack für den TeamSpeak-3-Client unter Linux. Die Farben folgen libadwaita (GNOME, dunkles Erscheinungsbild), die Symbole stammen aus dem Papirus-Dark-Thema.

Das Skript erzeugt elf Stile und elf Iconpacks:

• Adwaita-Dark und Papirus-Dark übernehmen die Akzentfarbe aus den GNOME-Einstellungen.
• Adwaita-Dark-Blue bis Adwaita-Dark-Maia und Papirus-Dark-Blue bis Papirus-Dark-Maia haben je eine der zehn GNOME-Akzentfarben fest eingebaut.

Getestet mit TeamSpeak 3.6.2 unter /opt/teamspeak3 auf Manjaro mit GNOME 50.

Voraussetzungen

• TeamSpeak-3-Client 3.6
• Python 3.11 oder neuer (nur Standardbibliothek)
• das Papirus-Icon-Theme unter /usr/share/icons/Papirus und /usr/share/icons/Papirus-Dark
• optional rsvg-convert (librsvg) zum Prüfen der erzeugten SVGs

Für die Vorschau-Werkzeuge kommen ImageMagick, Xvfb und xdotool dazu.

Installieren

python3 build.py --install

Das schreibt alle Varianten nach ~/.ts3client/styles/ und ~/.ts3client/gfx/. Ein anderes Profil geht mit --config-dir PFAD oder über die Umgebungsvariable TS3_CONFIG_DIR.

In TeamSpeak unter Extras → Optionen → Design dann das Thema Adwaita-Dark und das Icon Pack Papirus-Dark wählen. Nach einem Neustart von TeamSpeak ist alles übernommen.

Akzentfarbe automatisch übernehmen

tools/install-sync.sh

Das richtet den systemd-User-Dienst ts3-adwaita-accent.service ein. Er beobachtet org.gnome.desktop.interface accent-color und baut bei jeder Änderung Adwaita-Dark und Papirus-Dark neu, was rund eine Fünftelsekunde dauert. TeamSpeak lädt den Stil beim Start, die neue Farbe erscheint also nach dem nächsten Neustart des Clients. Der Dienst verweist auf diesen Ordner und funktioniert nur, solange das Repo dort liegt.

tools/install-sync.sh --remove schaltet den Dienst ab und löscht die Unit.

Entfernen

Zuerst in TeamSpeak ein anderes Thema und Icon Pack wählen, dann:

python3 build.py --uninstall
tools/install-sync.sh --remove

Windows

Für Windows gibt es unter Releases einen Installer, ts3-adwaita-theme-setup-<version>.exe. Er kopiert die zehn Akzent-Varianten nach %APPDATA%\TS3Client, mit Segoe UI statt Noto Sans als Schrift. Eine Variante, die der Windows-Akzentfarbe folgt, gibt es dort nicht. Beim Installieren wählt man eine Farbe, und der Installer trägt Stil und passendes Iconpack in package_inst_temp.ini ein. Diese Datei liest TeamSpeak beim nächsten Start, übernimmt die Auswahl und löscht sie wieder. Genauso aktiviert TeamSpeaks eigener Installer neue Add-ons.

Administratorrechte braucht der Installer nicht. Uninstaller und Lizenztexte liegen unter %LOCALAPPDATA%\ts3-adwaita-theme, entfernen lässt sich alles über Einstellungen → Apps. Der Installer ist nicht signiert, deshalb warnt Windows SmartScreen vor einem unbekannten Herausgeber. Über „Weitere Informationen" und „Trotzdem ausführen" startet er trotzdem.

Getestet ist alles mit dem Windows-Client 3.6.2 unter Wine: Installer, Aktivierung und Darstellung. Auf einem echten Windows fehlt der Test noch. Zeigt TeamSpeak dort Darstellungsfehler, hilft wahrscheinlich Extras → Optionen → Design → Stil: Fusion, denn mit Fusion ist der Stil gebaut.

Den Knopf „Overwolf installieren" gibt es nur unter Windows. Sein schwarzes Logo kommt fest aus TeamSpeak, kein Iconpack-Schlüssel und kein Stylesheet-Selektor erreicht es. Entfernen lässt er sich per Rechtsklick auf die Werkzeugleiste → Werkzeugleiste anpassen.

Selbst bauen:

tools/build-windows.sh

Das Skript braucht wine, xvfb-run und curl. Es lädt Inno Setup 6.7.3 von GitHub, prüft die SHA-256-Summe und richtet Inno Setup in einem eigenen Wine-Präfix unter ~/.cache/ts3-adwaita-theme ein. Mit /ACCENT=maia wählt man die Farbe beim Aufruf vor, mit /VERYSILENT /ACCENT=maia läuft die Installation ohne Fenster. /ACTIVATE=0 installiert nur und lässt die Auswahl in TeamSpeak, wie sie ist.

Warum es kein .ts3_style-Paket gibt

TeamSpeak hat einen eigenen Installer (package_inst) für .ts3_style- und .ts3_iconpack-Pakete. Mit mehreren Varianten in einem Paket benimmt er sich ungünstig: Er sortiert die Dateiliste selbst, schreibt den Paketnamen an den alphabetisch ersten Eintrag (hier -Blue) und aktiviert den letzten. Liegen die Dateien dagegen direkt im Profil, erkennt TeamSpeak sie beim Start und zeigt sie unter ihrem Dateinamen an. Iconpacks lädt TeamSpeak 3.6 außerdem nur als Zip-Archiv, ein Ordner gleichen Namens wird ignoriert.

Aufbau

Pfad	Inhalt
palette.toml	libadwaita-Farben, die zehn Akzentfarben, Farben der Gruppenabzeichen
style/adwaita-dark.qss.in	Qt-Stylesheet mit Platzhaltern wie @view_bg und @accent
style/adwaita-dark_chat.qss.in	Farben für Chatverlauf und Info-Ansicht
style/assets/	Häkchen, Radiopunkt, Pfeile und Schließen-Kreuz als SVG-Vorlagen
iconpack/mapping.toml	Zuordnung der 213 TeamSpeak-Symbolschlüssel zu Papirus-Symbolen
build.py	ersetzt die Platzhalter, färbt die Symbole ein, schreibt Stile und Zip-Archive
installer/	Inno-Setup-Skript und die Texte, die der Windows-Installer mitliefert
tools/	Kontaktbogen, Vorschau, Akzent-Sync, Windows-Build

Ohne Argumente baut build.py alle Varianten nach build/profile/ und prüft sie: Jedes SVG muss sich parsen und mit rsvg-convert rendern lassen, und alle Symbolschlüssel aus TeamSpeaks eigenem Mono-Pack müssen belegt sein.

Die Qt-Palette steht als Kommentarblock oben im Stylesheet (QPalette::Window = …;). TeamSpeak liest diese Zeilen selbst aus und setzt damit die Palette, das Stylesheet verfeinert danach nur noch einzelne Widgets. Papirus färbt seine Symbole über CSS-Klassen und currentColor. Das wertet QtSvg 5.15 nicht zuverlässig aus, deshalb setzt build.py die Farben direkt in die Pfade ein.

Symbole zuordnen

Ein Eintrag in iconpack/mapping.toml sieht so aus:

INPUT_MUTED = { src = "s:status/microphone-disabled", color = "destructive", solid = true }
CHANNEL_DELETE = { src = "shape:bubble", badge = "s:actions/window-close", badge_color = "destructive" }

src verweist auf ein Papirus-Symbol (a: für Papirus-Dark/16x16/actions, s: für Papirus/16x16/symbolic, d:, p: und m: für Geräte, Orte und Emotes) oder auf eine eigene Form aus build.py, etwa den Sprechpunkt oder die Kanal-Sprechblase. badge legt ein kleines Abzeichen unten rechts darüber. solid = true entfernt die Halbtransparenz, mit der Papirus manche Statussymbole zeichnet.

Ansehen, ohne den eigenen Client anzufassen

python3 build.py
tools/contact-sheet.sh Papirus-Dark      # build/contact-Papirus-Dark.png
tools/contact-sheet.sh --accents         # Akzentsymbole aller Varianten nebeneinander
tools/preview.sh start                   # TeamSpeak auf Xvfb, eigenes Profil, ohne Netz
tools/preview.sh shot bild.png
tools/preview.sh clean

preview.sh startet TeamSpeak mit eigenem HOME und TS3_CONFIG_DIR unter build/preview/, in einem Netz-Namensraum ohne Verbindung nach außen (unshare -c -n) und auf einem virtuellen Bildschirm. Ein laufender TeamSpeak-Client bleibt davon unberührt; beim Beenden erkennt das Skript die eigenen Prozesse an ihrer Umgebung, nicht an der Kommandozeile.

Lizenz

Der eigene Code (Skripte, Stylesheets, Formen, Zuordnung) steht unter der MIT-Lizenz, siehe LICENSE.

Das Repo enthält keine Papirus-Dateien. build.py liest die Symbole beim Bauen aus dem lokal installierten Papirus-Icon-Theme des Papirus Development Team. Die erzeugten Iconpacks sind davon abgeleitet und stehen deshalb wie Papirus unter der GPL-3.0. Der Windows-Installer enthält solche Iconpacks und liefert den GPL-3-Text und die Lizenzhinweise mit. Aus TeamSpeak selbst liest das Skript nur die Liste der Symbolschlüssel, ausgeliefert wird keine TeamSpeak-Datei.

Dies ist kein offizielles Projekt von TeamSpeak Systems, der GNOME Foundation oder des Papirus Development Team. TeamSpeak ist eine Marke der TeamSpeak Systems GmbH. The GNOME logo and GNOME name are registered trademarks or trademarks of GNOME Foundation in the United States or other countries.