Contrôler un serveur multimédia depuis la ligne de commande

La commande quven démarre, arrête, vérifie, lie et met à jour un serveur Quven. Elle compte surtout sur une machine sans écran, où le terminal est tout ce que vous avez.

Lancer la commande

Le Bundle installe un lanceur quven sous Windows et macOS au démarrage de l’application de bureau : ouvrez donc un nouveau terminal après le premier démarrage.

• Windows : %LocalAppData%\Quven\bin, ajouté à votre chemin d’utilisateur.
• macOS : ~/.local/bin, ajouté au profil zsh.

Le Serveur seul n’a ni application de bureau ni lanceur. Appelez le fichier du serveur avec les mêmes arguments : quven status devient alors :

# 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

Tout ce qui suit fonctionne de la même façon avec l’une ou l’autre écriture.

Démarrer, arrêter et vérifier

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

• start lance le serveur en arrière-plan et rend la main dès qu’il répond.
• stop lui demande de s’arrêter et attend qu’il se soit fermé. restart fait les deux.
• status indique si le serveur est en marche, à quel compte il est lié, l’accès à distance et toute mise à jour en attente. info ajoute la version, l’adresse et les dossiers utilisés.
• logs affiche les dernières lignes du journal du serveur et -f le suit. --errors ne garde que les avertissements et les erreurs.

Comprendre pourquoi il n’a pas démarré

quven logs --faults
quven doctor

logs --faults lit le fichier où un démarrage échoué s’explique. doctor vérifie le dossier de données, l’espace disque et le journal à la recherche d’anomalies du dernier jour ; serveur démarré, il lit aussi la liaison du compte, l’accès à distance et les mises à jour. Il se termine par le code 61 quand il trouve un problème, et de simples avertissements se terminent toujours par 0.

Lier le serveur à votre compte

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

account link affiche un code et une adresse. Ouvrez l’adresse, connectez-vous et approuvez le serveur, puis laissez la commande s’exécuter jusqu’à sa confirmation : un code expiré demande une nouvelle exécution. Les trois commandes exigent que le serveur soit en marche.

L’accès à distance géré fait partie de Pro :

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

Mettre à jour

quven update --check
quven update

--check se contente de signaler. update télécharge et installe, puis attend le redémarrage du serveur. Les deux exigent que le serveur soit en marche : démarrez d’abord celui que vous avez arrêté pour la nuit, sinon la commande se termine par le code 1 en disant qu’aucun serveur ne répond. Avec --check, le code 20 n’est pas un échec : il signifie qu’une mise à jour est disponible.

L’utiliser dans un script

La plupart des commandes acceptent --json pour une ligne de JSON, et --no-color ou la variable NO_COLOR demande une sortie simple. logs, completions et help n’acceptent pas --json.

Code de retour	Signification
0	Terminé
1	Le serveur n’est pas en marche, ou n’a pas pu démarrer
2	La ligne de commande n’a pas été comprise
20	update --check a trouvé une mise à jour
61	doctor a trouvé un problème
130	Interrompu

Chaque commande a aussi ses propres codes d’échec, comme 23 quand une mise à jour échoue ou 32 quand la liaison du compte échoue, et quven help <command> les énumère.

Une vérification nocturne qui n’installe une mise à jour que s’il y en a une :

#!/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

La complétion du shell et les options d’une commande :

quven completions bash
quven help status
quven help completions

quven help liste toutes les commandes, et help completions nomme les autres shells.

Sous Linux, quand le serveur s’exécute comme service systemd, arrêtez-le et redémarrez-le avec systemctl, jamais avec quven stop ni quven restart. L’unité relance tout ce qui s’arrête : les deux entreraient en concurrence et le serveur pourrait revenir un instant après que vous l’avez arrêté volontairement.

Questions fréquentes