# 🖥️ Noxely — serveur

Le serveur porte tout ce qui coûtait de la batterie au téléphone : la recherche dans les
catalogues, le guet des radios, l'enregistrement et le téléchargement. Le mobile ne fait plus que
récupérer des fichiers prêts.

## Installation

```bash
make server-venv                 # crée le venv et installe les dépendances
cp server/.env.example server/.env   # puis renseigner NOXELY_TOKEN
make server-run                  # lancement au premier plan, pour essayer
```

L'interface de pilotage est à `http://<hôte>:8710` — recherche, guets, file et bibliothèque.
Le jeton se saisit une fois dans l'en-tête de la page.

## En service

```bash
make server-install              # unité systemd (sudo demandé)
make server-status               # état
make server-logs                 # journal suivi
```

## API

| Route | Qui l'utilise |
|---|---|
| `GET /api/health` | tout le monde, sans jeton |
| `GET /api/library?since=<curseur>` | **le mobile** — uniquement ce qui a changé |
| `GET /api/media/{id}/file` | **le mobile** — le fichier |
| `GET /api/search`, `/api/tracks`, `POST /api/queue` | l'interface web |
| `GET/POST/DELETE /api/watches`, `POST /api/watches/sweep` | l'interface web |
| `GET /api/radio/stations`, `POST /api/radio/record`, `POST /api/radio/record/{id}/stop`, `GET /api/radio/recordings` | l'interface web — stations, enregistrement à la demande |
| `GET /api/heard?limit=&q=` | l'interface web — l'historique de ce qui a été entendu |
| `GET /api/rotation?last=100&top=20` | l'interface web — ce qui tourne sur les *n* dernières remontées |

Toutes les routes sauf `/api/health` exigent l'en-tête `X-Noxely-Token`.

## Radio : écouter et enregistrer

L'onglet **📻 Radio** liste les stations (annuaire Radio Browser, filtrables par genre et par nom).
Chacune peut s'écouter en direct dans le navigateur, ou s'enregistrer jusqu'à l'arrêt — ou pour
une durée choisie (15 min à 2 h). Jusqu'à quatre stations en parallèle.

Un enregistrement rejoint la bibliothèque comme n'importe quel média : on le réécoute depuis
l'interface web, et le mobile le récupère à sa prochaine synchronisation. Si le flux tombe, le
serveur le rouvre (jusqu'à cinq essais d'affilée) et continue dans le même fichier. Un
redémarrage du service clôt proprement les enregistrements en cours. `NOXELY_RECORD_MAX_MINUTES`
(180) plafonne la durée, pour qu'un enregistrement oublié ne remplisse pas le disque.

## Historique et rotation

Le serveur note chaque titre annoncé par les stations qu'il balaie (ICY), même quand aucun
morceau n'est guetté. Une station qui n'a pas changé de morceau depuis le dernier tour n'ajoute
rien, et celles qui n'annoncent qu'elles-mêmes sont écartées.

La **rotation** compte, sur les *n* dernières remontées (100 par défaut), les passages de chaque
titre et de chaque artiste, avec le nombre de stations distinctes qui les diffusent.

Sans guet en cours, un tour a lieu toutes les `NOXELY_LISTEN_INTERVAL` secondes (60 par défaut)
— quelques dizaines de kilo-octets par station. `NOXELY_HISTORY=0` coupe l'historique ; les
lignes plus vieilles que `NOXELY_HISTORY_DAYS` (90) sont purgées.

## Licence

GPL v3, comme le reste du projet — voir [`../LICENSE`](../LICENSE).

## Données

```
$NOXELY_DATA/
├── noxely.sqlite3   index des médias, des guets et de l'historique des écoutes
└── media/           les fichiers eux-mêmes
```