El daemon y los registros

El daemon

ampd guarda la biblioteca y reproduce la música. Cada interfaz es su cliente: la terminal, la ventana (amp-qt), el teléfono, amp --next. Por eso dos terminales que ejecutan amp muestran la misma cola, y una tecla pulsada en una se ve en la otra.

amp inicia el daemon cuando no hay ninguno en marcha; después sobrevive a la terminal de la que salió.

amp daemon status                   # si está en marcha, su pid, dónde escucha
amp daemon start                    # iniciarlo ahora (al iniciar sesión, desde un script)
amp daemon stop                     # detenerlo, y la música con él
amp --no-daemon                     # el reproductor solo dentro de esta terminal

Escucha en un socket al que solo tu usuario puede acceder, y pide a cada cliente una clave que solo tu usuario puede leer.

Una máquina que solo reproduce — un pequeño servidor junto a los altavoces — necesita solo el daemon: uv tool install ./amp-core instala ampd.

La ventana

amp-qt es la misma interfaz en una ventana de escritorio, sobre el mismo daemon. Ejecútala junto a la terminal o en su lugar; cada una sigue lo que hace la otra.

Registros

La terminal es la pantalla de amp, así que no se imprime nada en ella. Cada programa escribe un archivo de trazas en su lugar, todos en la misma carpeta:

Archivo	Lo escribe
ampd.log	el daemon: reproducción, biblioteca, controles remotos — normalmente el que hay que leer
amp.log	el reproductor de terminal
amp-qt.log	la ventana

La carpeta es ~/Library/Application Support/amp/ en macOS, ~/.local/share/amp/ en Linux, %LOCALAPPDATA%\amp\ en Windows. amp --log-path la muestra.

tail -f "$(dirname "$(amp --log-path)")/ampd.log"       # seguir el daemon
amp daemon stop && amp --log-level debug                # reiniciar ambos con más detalle

Algo va mal

1. amp --diagnose — ¿encuentra libmpv? ¿Qué puede mostrar la terminal?
2. amp daemon stop, y luego amp de nuevo — un daemon de una versión anterior es el sospechoso habitual tras una actualización.
3. Mira en ampd.log. Cada ejecución empieza con una línea de = seguida de la versión, Python y el sistema: pega esas líneas en tu informe.