feat: Playtube Stream Dock Plugin 1.0.0 (Ajazz AKP153E) mit Icon-Pack

2026-09-26 21:00:36 +02:00
commit 179a785adb
221 changed files with 10254 additions and 0 deletions
@@ -0,0 +1,64 @@
+# Playtube – Stream Dock Plugin
+
+Plugin für **Stream Dock** (Ajazz AKP153E und andere Mirabox/HotSpot-Geräte), mit dem du
+[Playtube](https://git.fojadrachi.de/admin/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
+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
+
+```bash
+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.