Zum Inhalt

Headless-Musikplayer auf dem Thin Client bei Papa — gesteuert per Plexamp-App.

Status: ✅ Abgeschlossen (2026-03-01)

Übersicht

Plexamp Headless läuft als systemd-Service auf dem TC bei Papa (tcbackup). Er verbindet sich mit dem Plex-Server auf dem NAS und gibt Audio über den analogen Klinkenausgang aus. Steuerung erfolgt über die Plexamp-App (Handy/Desktop) als Player "tcbackup".

Installation

Voraussetzungen

sudo apt-get install -y nodejs npm alsa-utils expect
  • Node.js v20.19.2
  • Kein Docker — bare metal Installation

Plexamp herunterladen

curl -sL https://plexamp.plex.tv/headless/Plexamp-Linux-headless-v4.11.0.tar.bz2 | sudo tar -xj -C /opt
# Installiert nach: /opt/plexamp/

Erstmalige Registrierung (Claim)

Claim-Token unter https://www.plex.tv/claim holen (nur 4 Minuten gültig!), dann:

expect -c "
  spawn env HOME=/home/claude node /opt/plexamp/js/index.js
  expect {claim token:}
  send {CLAIM_TOKEN
}
  expect {player a name}
  send {tcbackup
}
  expect -timeout 30 {Starting}
  sleep 10
"

Config wird gespeichert in: /home/claude/.local/share/Plexamp/Settings/

Systemd-Service

/etc/systemd/system/plexamp.service:

[Unit]
Description=Plexamp Headless
After=network-online.target sound.target
Requires=network-online.target
[Service]
Type=simple
User=claude
WorkingDirectory=/opt/plexamp
ExecStart=/usr/bin/node /opt/plexamp/js/index.js
Restart=on-failure
RestartSec=5
Environment=HOME=/home/claude
[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable plexamp
sudo systemctl start plexamp

Technische Details

| Eigenschaft | Wert | | Version | Plexamp 4.11.0 | | Host | tcbackup (100.65.43.96 via Tailscale) | | Player-Name | tcbackup | | Audio-Output | HDA Intel PCH — Analog/Klinke (Card 0) | | Port | 32500 (Web-UI, intern) | | Plex-Server | NAS (192.168.178.20) via Plex.tv Account | | Autostart | systemd (enabled) | | Config-Verzeichnis | /home/claude/.local/share/Plexamp/Settings/ |

Hinweise

Docker nicht möglich: Das Linuxserver-Image (ghcr.io/linuxserver/plexamp) ist deprecated. Bare-metal ist stabiler und einfacher. Verbindungsfehler 172.x: Beim Start erscheinen Fehler für Docker-IPs — normal, da kein lokaler Plex-Server auf dem TC läuft. Plexamp verbindet sich über Plex.tv.

Service-Befehle:

sudo systemctl status plexamp
sudo systemctl restart plexamp
journalctl -u plexamp -f

← Zurück zur tcbackup-Übersicht · ← Server-Übersicht