Audio en red · Plexamp Headless · Soporte

Plexamp Headless no aparece en la app: recuperar el inicio de sesión en Raspberry Pi

Última revisión: 29/10/2026 · Probado con Plexamp Headless sobre Raspberry Pi OS

Reproductor Plexamp Headless en una Raspberry Pi junto a un cable de red, para la guía de recuperación de sesión

Si Plexamp Headless desaparece de la app de Plexamp o del selector de reproductores, el arreglo casi nunca es reinstalar. Lo normal es que la sesión del player se haya desvinculado por un cambio de contraseña de Plex, una actualización de Plexamp Headless o un reinicio con caché corrupta. El orden que funciona es este: cerrar sesión en la interfaz headless, volver a entrar y re-vincular el player con el icono Cast.

El síntoma

Te encuentras una de estas tres situaciones:

Los tres apuntan al mismo sitio: la vinculación de cuenta. La app no usa una conexión permanente al servicio local, usa un token de Plex que puede caducar o revocarse.

Arreglo rápido

  1. Abre la interfaz headless en el navegador: http://nombre-de-tu-pi:32500.
  2. Ve a Settings → Account, pulsa Sign out y confirma.
  3. Vuelve a entrar con tu cuenta de Plex. Es normal que pida abrir una página de autorización en plex.tv.
  4. En la app de Plexamp, toca el icono Cast y vuelve a seleccionar el player headless.
  5. Comprueba que el nombre del player coincide con el que configuraste y que el volumen no quedó a cero.

Este orden está copiado del gist de tgp-2 y del instalador de odinb para Plexamp Headless, que hasta hoy es la referencia más repetida en foros. En ambos, el paso de "cerrar sesión, entrar de nuevo y re-seleccionar con el Cast" es el que resuelve la mayoría de los casos.

Vista lateral de la Raspberry Pi 4 Model B, el hardware sobre el que corre Plexamp Headless
Una Raspberry Pi 4 Model B. Plexamp Headless se instala como servicio local y no depende de una pantalla conectada.
Foto: Laserlicht, CC BY-SA 4.0, vía Wikimedia Commons

Tabla de diagnóstico

Síntoma, causa probable y primer paso
Síntoma Causa más probable Primer paso
El player no aparece en Plexamp Sesión desvinculada tras un cambio de contraseña de Plex Abrir hostname:32500, cerrar sesión y volver a entrar
Aparece pero no reproduce Token caducado o caché antigua Desvincular el player y volver a seleccionarlo con el icono Cast
La interfaz 32500 no carga Servicio systemd parado systemctl --user status plexamp.service y reiniciar
Pide inicio de sesión en bucle Sesión revocada desde la cuenta de Plex Reiniciar el servicio y repetir el inicio desde cero

Suscríbete

Cada domingo un YAML de audio en red ya probado y el aviso cuando Plexamp Headless o Music Assistant cambian algo que rompe lo local. Nada de PDF por correo: el material vive en las plantillas YAML.

Cuándo hay que tocar el servicio systemd

Si la interfaz 32500 no carga, el problema no es la cuenta: es el servicio. Comprueba su estado con:

systemctl --user status plexamp.service

Y si está caído o se reinició solo, fuerza el reinicio:

systemctl --user restart plexamp.service
journalctl --user -u plexamp.service -n 50

El último comando es el que da la pista real. Busca errores de plex.tv que mencionen token, unauthorized o connection refused. Si ves unauthorized después de un cambio de contraseña, el arreglo es el de arriba: cerrar sesión y volver a entrar.

Si instalaste Plexamp Headless con una imagen preconfigurada, el usuario puede no ser pi. Comprueba el unit file y ajusta las rutas antes de asumir que el servicio no existe.

La guía de instalación completa está en Plexamp Headless en Raspberry Pi. Esta pieza cubre solo la recuperación de la vinculación de cuenta y el servicio.

No te quedes con el tutorial a medias

El domingo mando el cambio que me haya roto algo en local durante la semana y el YAML con el que lo arreglé. Mismo trato, sin promesas de PDF que nadie enviaría.