65 lines
3.0 KiB
Markdown
65 lines
3.0 KiB
Markdown
# 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.
|