Controla un servidor multimedia desde la línea de comandos

El comando quven inicia, detiene, comprueba, vincula y actualiza un servidor Quven. Importa sobre todo en una máquina sin pantalla, donde el terminal es todo lo que tienes.

Ejecuta el comando

El Bundle instala un lanzador quven en Windows y macOS cuando arranca la aplicación de escritorio, así que abre un terminal nuevo después del primer arranque:

• Windows: %LocalAppData%\Quven\bin, añadido a la ruta de tu usuario.
• macOS: ~/.local/bin, añadido al perfil de zsh.

Solo servidor no tiene aplicación de escritorio ni lanzador. Llama al archivo del servidor con los mismos argumentos, de modo que quven status pasa a ser:

# Windows, from the install folder
Quven.Local.Server status

# Linux AppImage
./Quven-Server-*-linux-x64.AppImage status

# Docker image
docker compose exec quven /app/Quven.Local.Server status

Todo lo que sigue funciona igual con cualquiera de las dos formas.

Inicia, detén y comprueba

quven start
quven status
quven info
quven logs -f
quven stop

• start lanza el servidor en segundo plano y devuelve el control en cuanto responde.
• stop le pide que se apague y espera hasta que se ha cerrado. restart hace las dos cosas.
• status muestra si el servidor está en marcha, a qué cuenta está vinculado, el acceso remoto y cualquier actualización pendiente. info añade la versión, la dirección y las carpetas que usa.
• logs imprime las últimas líneas del registro del servidor y -f lo sigue. --errors deja solo advertencias y errores.

Averigua por qué no arrancó

quven logs --faults
quven doctor

logs --faults lee el archivo donde un arranque fallido se explica. doctor comprueba la carpeta de datos, el espacio en disco y el registro en busca de fallos del último día, y con el servidor en marcha también lee la vinculación de la cuenta, el acceso remoto y las actualizaciones. Termina con el código de salida 61 cuando encuentra un problema, y las simples advertencias siguen terminando en 0.

Vincula el servidor a tu cuenta

quven account link
quven account status
quven account unlink --yes

account link imprime un código y una dirección. Abre la dirección, inicia sesión y aprueba el servidor, y deja el comando en ejecución hasta que lo confirme, porque un código caducado exige una nueva ejecución. Los tres comandos necesitan que el servidor esté en marcha.

El acceso remoto gestionado pertenece a Pro:

quven remote-access status
quven remote-access on
quven remote-access off

Actualiza

quven update --check
quven update

--check solo informa. update descarga e instala y luego espera a que el servidor se reinicie. Ambos necesitan el servidor en marcha, así que inicia primero el que detuviste por la noche, o el comando termina con el código de salida 1 y dice que no hay ningún servidor que responda. Con --check, el código de salida 20 no es un fallo: significa que hay una actualización disponible.

Úsalo en un script

La mayoría de los comandos aceptan --json para una línea de JSON, y --no-color o la variable NO_COLOR piden una salida sin formato. logs, completions y help no aceptan --json.

Código de salida	Significado
0	Hecho
1	El servidor no está en marcha, o no pudo iniciarse
2	No se entendió la línea de comandos
20	update --check encontró una actualización
61	doctor encontró un problema
130	Interrumpido

Cada comando tiene además sus propios códigos de fallo, como 23 cuando falla una actualización o 32 cuando falla la vinculación de la cuenta, y quven help <command> los enumera.

Una comprobación nocturna que instala una actualización solo cuando la hay:

#!/bin/sh
quven update --check
case $? in
  20) quven update ;;
  0)  echo "up to date" ;;
  *)  echo "server not running or update check failed" >&2; exit 1 ;;
esac

El autocompletado del shell y las opciones de un comando:

quven completions bash
quven help status
quven help completions

quven help lista todos los comandos, y help completions nombra los demás shells.

En Linux, cuando el servidor se ejecuta como servicio de systemd, deténlo y reinícialo con systemctl y nunca con quven stop ni quven restart. La unidad vuelve a iniciar todo lo que se cierra, así que ambos competirían y el servidor podría volver un instante después de que lo detuvieras a propósito.

Preguntas frecuentes