Playtube – Stream Dock Plugin

Plugin für Stream Dock (Ajazz AKP153E und andere Mirabox/HotSpot-Geräte), mit dem du Playtube steuern kannst: Wiedergabe, Lautstärke (lauter/leiser/stumm), Playlist-Auswahl, Cover und Titel auf den Tasten.

Voraussetzungen

• Stream Dock Software ab 3.10.188 (Windows), Gerät z. B. Ajazz AKP153E.
• Playtube ab 4.5.1 (oder Playtube Edge), denn erst ab dieser Version gibt es die lokale Fernsteuerung. Das Plugin verbindet sich über eine Named Pipe (\\.\pipe\Playtube.Remote.<Name>, nur dein Windows-Benutzer) – kein Netzwerk, kein Konto.
• Ohne laufendes Playtube zeigen die Tasten „Playtube offline".

Installieren

powershell -ExecutionPolicy Bypass -File install.ps1

Danach Stream Dock komplett beenden (Tray-Symbol → Beenden) und neu starten. Die Aktionen findest du in der Kategorie Playtube. Das Skript installiert auch das Icon-Pack.

Aktionen

Aktion	Was sie tut
Wiedergabe/Pause	Umschalten, Symbol zeigt den Zustand
Vorheriger / Nächster Titel	Titel springen
Zurück-/Vorspulen	± Sekunden (einstellbar)
Lauter / Leiser	Schrittweite einstellbar, gedrückt halten wiederholt
Lautstärke setzen	Feste Lautstärke
Stumm	Ton aus/ein, zeigt die Lautstärke
Aktueller Titel	Cover und Titel; auf dem Info-Display eine große Karte mit Interpret und Fortschritt
Gefällt mir, Zufall, Wiederholen	Umschalten, Symbol zeigt den Zustand
Playlist abspielen	Playlist aus YouTube Music wählen (Liste wird von Playtube geladen)
Tab wechseln / Playtube anzeigen	YouTube ↔ YouTube Music, Fenster nach vorn

Pro Taste einstellbar: Ziel-Tab (automatisch = aktiver Tab, YouTube oder YouTube Music), je nach Aktion Schrittweite, Sekunden, Lautstärke, Playlist, Titelanzeige. Alle Aktionen sind auch auf den Info-Feldern rechts am Gerät nutzbar.

Icon-Pack

iconpack/com.fojadrachi.playtube.sdIconPack enthält 75 Symbole im Playtube-Look (Verlauf violett → pink): Ordner, Pfeile, Einstellungen, Player-Symbole und vereinfachte App-Symbole (Chrome, Discord, Steam, …; eigene Zeichnungen, keine Original-Logos). Zwei Varianten: gradient_* und dark_*. In der Stream-Dock-Software über das Bild einer Taste auswählbar.

Entwicklung

npm install
npm test              # 40 Tests (Node >= 20)
npm run build         # bündelt src/ nach com.fojadrachi.playtube.sdPlugin/plugin/index.js
npm run assets        # erzeugt manifest.json, Übersetzungen und Tasten-Icons
npm run iconpack      # erzeugt das Icon-Pack (+ Zip in dist/)
npm run package       # Zip des Plugins in dist/

Aufbau: src/playtubeClient.js (Pipe-Protokoll), src/actions.js (Aktionen, reine Funktionen), src/controller.js (Tasten ↔ Playtube), src/infoPanel.js (Karte fürs Info-Display), src/host.js (Stream-Dock-WebSocket), tools/ (Icon-Generator). Das gebündelte plugin/index.js liegt im Repo, damit install.ps1 ohne Build funktioniert.