Artist Watch: a catalogue of the artist's releases, with a switch per release

docs/api-reference.md

@@ -2501,8 +2501,9 @@ Update a watch.
 | `url` | string | A new link for the watch — same kinds as in `POST` |
 | `release_types` | array | Artist watches only — as in `POST` |
 | `new_only` | boolean | Artist watches only. `true` records whatever is out at the next check as skipped; `false` forgets the skipped releases so the next check downloads them |
+| `musicbrainz_kinds` | array or `null` | Artist watches only. The MusicBrainz secondary types this watch downloads: any of `mixtape`, `soundtrack`, `live`, `compilation`, `remix`, `dj-mix`, `demo`; `null` follows the `artist_watch_musicbrainz_kinds` setting. `400` for anything else |
 
-Changing `release_types` or `new_only` starts a check in the background if the watch is enabled, and is a `400` on a playlist watch. A `url` that points at the **same** playlist or artist only replaces the stored `url`. One that points at a **different** playlist or artist of the same kind retargets the watch: `spotify_id`, `name` and `url` change, `last_checked` becomes `null`, `last_track_count` becomes `0`, and its downloaded-track and seen-release history is cleared. If the watch is enabled, a first check starts in the background, as after `POST`. An unchanged `url` is ignored.
+Changing `release_types`, `new_only` or `musicbrainz_kinds` starts a check in the background if the watch is enabled, and is a `400` on a playlist watch. A `url` that points at the **same** playlist or artist only replaces the stored `url`. One that points at a **different** playlist or artist of the same kind retargets the watch: `spotify_id`, `name` and `url` change, `last_checked` becomes `null`, `last_track_count` becomes `0`, and its downloaded-track and seen-release history is cleared. If the watch is enabled, a first check starts in the background, as after `POST`. An unchanged `url` is ignored.
 
 **Response:** Updated watch object. `404` if there is no such watch; for a new `url`: `400` if it isn't a supported link or is the other kind (an artist link for a playlist watch, or the reverse), `409` if another watch already follows it, `404`/`502` if it can't be resolved. On an error nothing is changed.
 
@@ -2646,6 +2647,51 @@ The songs a watch holds, newest first, as [`GET /tracks`](#get-tracks) rows —
 
 ---
 
+### `GET /api/monitor/playlists/{playlist_id}/releases`
+
+An artist watch's whole catalogue as of its last check: every release YouTube Music, Deezer and MusicBrainz list, one row per release (the same name and type from two catalogues is merged), with what the library has of it. See [An artist's releases](features/playlist-monitor.md#an-artists-releases). `400` for a playlist or podcast watch.
+
+**Response:**
+
+```json
+{
+  "watch": { "id": 1, "name": "Drake", "kind": "artist", "musicbrainz_kinds": null, "…": "…" },
+  "kinds": ["mixtape", "soundtrack"],
+  "kinds_default": true,
+  "available_kinds": ["mixtape", "soundtrack", "live", "compilation", "remix", "dj-mix", "demo"],
+  "musicbrainz": true,
+  "releases": [
+    {
+      "id": "deezer:13082992",
+      "album_ids": ["deezer:13082992"],
+      "name": "Views",
+      "release_type": "album",
+      "kinds": [],
+      "section": "album",
+      "year": "2016",
+      "sources": ["deezer"],
+      "cover_url": "https://…",
+      "url": "https://www.deezer.com/album/13082992",
+      "state": "complete",
+      "have": 20,
+      "total": 20,
+      "choice": ""
+    }
+  ],
+  "counts": { "complete": 1, "partly": 0, "missing": 0, "skipped": 0, "not_watched": 0, "off": 0, "not_own": 0 }
+}
+```
+
+`state` is `complete` (every track in the library), `partly`, `missing` (wanted, not there yet), `skipped` (out before a "new releases only" watch started), `not_watched` (a type or kind the watch doesn't download), `off` (switched off) or `not_own` (a guest spot or a bootleg, never downloaded). `total` is `0` until the release's tracklist was fetched. `section` is `album`, `mixtape`, `ep`, `single` or `other`. `choice` is the user's switch: `on`, `off` or `""` (the watch's rules).
+
+---
+
+### `PATCH /api/monitor/playlists/{playlist_id}/releases`
+
+Switch releases of an artist watch: `{ "album_ids": ["deezer:13082992"], "choice": "on" }`, with `album_ids` from a release's `album_ids`. `on` downloads them even when their type isn't watched or they came out before a "new releases only" watch started, and starts a check if the watch is enabled. `off` never downloads them (songs already there stay). `""` follows the watch again. **Response:** as `GET`. `400` for a bad body, `404` when the watch lists none of `album_ids`.
+
+---
+
 ### `GET /api/monitor/artist-suggestions`
 
 Artists to follow, for the Monitor page's Artists tab: two lists, ranked from what the server already keeps — nothing is searched for. See [Suggested artists](features/playlist-monitor.md#suggested-artists).

docs/bg/features/playlist-monitor.md

@@ -284,6 +284,12 @@ Top 50 - USA        →  new song appears   →  Downtify downloads it
 
 Id на следенето (`#12`) стои до името му, така че две следения на една и съща връзка — например два акаунта, които следят един плейлист — да се различават.
 
+### Изданията на изпълнител
+
+Страницата на следене на изпълнител показва и целия му каталог към последната проверка: всяко издание, което YouTube Music, Deezer и MusicBrainz показват (един и същ албум от два източника се показва веднъж), разделени на албуми, микстейпове, EP-та, сингли и концертни издания, компилации и ремикси. Всяко показва какво има библиотеката от него: **Пълно** с броя песни, **Частично**, **За изтегляне**, **Излязло преди следенето** (следене с **Само нови издания** го е пропуснало), **Не се следи** (тип или вид, който следенето не изтегля) или **Изключено**. Гостуванията и бутлезите имат собствен филтър и никога не се изтеглят.
+
+Превключвателят до изданието има предимство пред следенето, като наблюдението по албум в Lidarr. Включен, изтегля изданието, дори ако типът му не се следи или е излязло преди началото на следенето, и проверка започва веднага. Изключен, спира изтеглянето му. Песните, които вече са в библиотеката, остават и в двата случая. **От MusicBrainz изтегляй също** избира, само за този изпълнител, кои видове издания, които само MusicBrainz различава, се изтеглят: по подразбиране микстейпове и саундтраци; концертни албуми, компилации, ремикси, DJ миксове и демо записи, когато са включени.
+
 ## Откъде е дошла една песен
 
 **Откъде е дошла** в менюто на песен (навсякъде в библиотеката) казва кое следене я е изтеглило първо, кога и с кой доставчик — **Първа проверка**, ако е дошла с първата проверка — и изброява всяко следене, което я има сега, всяко с id, собственик (за администратор), кога е получило песента и как: **Изтегли я**, **Вече в библиотеката** или **Преди записването**. Това е един файл: следенията, които споделят песен, сочат към едно и също копие.

docs/de/features/playlist-monitor.md

@@ -284,6 +284,12 @@ Die Seite einer Beobachtung zeigt außerdem:
 
 Die Id der Beobachtung (`#12`) steht neben ihrem Namen, damit sich zwei Beobachtungen desselben Links — etwa zwei Konten, die derselben Playlist folgen — unterscheiden lassen.
 
+### Die Veröffentlichungen eines Künstlers
+
+Die Seite einer Künstlerbeobachtung listet auch den ganzen Katalog des Künstlers, Stand der letzten Prüfung: jede Veröffentlichung, die YouTube Music, Deezer und MusicBrainz listen (dasselbe Album aus zwei Quellen erscheint einmal), unter Alben, Mixtapes, EPs, Singles sowie Live-, Compilation- und Remix-Veröffentlichungen. Jede zeigt, was die Bibliothek davon hat: **Vollständig** mit ihrer Titelzahl, **Teilweise**, **Herunterzuladen**, **Vor der Beobachtung erschienen** (eine Beobachtung mit **Nur neue Veröffentlichungen** hat sie übersprungen), **Nicht beobachtet** (ein Typ oder eine Art, die die Beobachtung nicht herunterlädt) oder **Aus**. Gastauftritte und Bootlegs haben einen eigenen Filter und werden nie heruntergeladen.
+
+Der Schalter neben einer Veröffentlichung hat Vorrang vor der Beobachtung, wie Lidarrs Überwachung pro Album. Ein lädt sie herunter, auch wenn ihr Typ nicht beobachtet wird oder sie vor Beginn der Beobachtung erschien, und eine Prüfung startet sofort. Aus lädt sie nicht mehr herunter. Songs, die schon in der Bibliothek sind, bleiben in beiden Fällen. **Von MusicBrainz auch herunterladen** wählt, nur für diesen Künstler, welche Arten von Veröffentlichungen, die nur MusicBrainz unterscheidet, heruntergeladen werden: standardmäßig Mixtapes und Soundtracks; Live-Alben, Compilations, Remixe, DJ-Mixe und Demos, wenn eingeschaltet.
+
 ## Woher ein Titel kommt
 
 **Woher er kommt** im Menü eines Titels (überall in der Bibliothek) sagt, welche Beobachtung ihn zuerst heruntergeladen hat, wann und mit welchem Anbieter — **Erste Prüfung**, wenn er mit der ersten Prüfung kam — und listet jede Beobachtung auf, die ihn jetzt hat, jeweils mit Id, Besitzer (für einen Admin), wann sie den Titel bekam und wie: **Hat ihn geladen**, **Schon in der Bibliothek** oder **Vor der Erfassung**. Es ist eine Datei: Beobachtungen, die einen Titel teilen, zeigen alle auf dieselbe Kopie.

docs/el/features/playlist-monitor.md

@@ -284,6 +284,12 @@ Top 50 - USA        →  new song appears   →  Downtify downloads it
 
 Το id της παρακολούθησης (`#12`) φαίνεται δίπλα στο όνομά της, ώστε να ξεχωρίζουν δύο παρακολουθήσεις του ίδιου συνδέσμου — π.χ. δύο λογαριασμοί που ακολουθούν την ίδια λίστα.
 
+### Οι κυκλοφορίες ενός καλλιτέχνη
+
+Η σελίδα μιας παρακολούθησης καλλιτέχνη δείχνει και όλο τον κατάλογό του στον τελευταίο έλεγχο: κάθε κυκλοφορία που δείχνουν τα YouTube Music, Deezer και MusicBrainz (το ίδιο άλμπουμ από δύο πηγές εμφανίζεται μία φορά), σε άλμπουμ, mixtape, EP, σινγκλ και κυκλοφορίες live, συλλογών και remix. Η καθεμία δείχνει τι έχει η βιβλιοθήκη από αυτήν: **Πλήρες** με τον αριθμό κομματιών, **Εν μέρει**, **Για λήψη**, **Πριν την παρακολούθηση** (μια παρακολούθηση **Μόνο νέες κυκλοφορίες** την παρέλειψε), **Χωρίς παρακολούθηση** (ένας τύπος ή ένα είδος που η παρακολούθηση δεν κατεβάζει) ή **Ανενεργό**. Οι συμμετοχές και τα bootleg έχουν δικό τους φίλτρο και δεν κατεβαίνουν ποτέ.
+
+Ο διακόπτης δίπλα σε μια κυκλοφορία υπερισχύει της παρακολούθησης, όπως η παρακολούθηση ανά άλμπουμ του Lidarr. Ενεργός, την κατεβάζει ακόμη κι αν ο τύπος της δεν παρακολουθείται ή αν κυκλοφόρησε πριν ξεκινήσει η παρακολούθηση, και ένας έλεγχος ξεκινά αμέσως. Ανενεργός, σταματά τη λήψη της. Τα τραγούδια που υπάρχουν ήδη στη βιβλιοθήκη μένουν και στις δύο περιπτώσεις. Το **Από το MusicBrainz, λήψη επίσης** επιλέγει, μόνο για αυτόν τον καλλιτέχνη, ποια είδη κυκλοφορίας που ξεχωρίζει μόνο το MusicBrainz κατεβαίνουν: εξ ορισμού mixtape και soundtrack· live άλμπουμ, συλλογές, remix, DJ mix και demo όταν ενεργοποιηθούν.
+
 ## Από πού ήρθε ένα τραγούδι
 
 Το **Από πού ήρθε** στο μενού ενός τραγουδιού (οπουδήποτε στη βιβλιοθήκη) λέει ποια παρακολούθηση το κατέβασε πρώτη, πότε και με ποιον πάροχο — **Πρώτος έλεγχος** αν ήρθε με τον πρώτο έλεγχο — και απαριθμεί κάθε παρακολούθηση που το έχει τώρα, η καθεμία με το id της, τον κάτοχο (για διαχειριστή), πότε πήρε το τραγούδι και πώς: **Το κατέβασε**, **Ήδη στη βιβλιοθήκη** ή **Πριν την καταγραφή**. Είναι ένα αρχείο: οι παρακολουθήσεις που μοιράζονται ένα τραγούδι δείχνουν όλες στο ίδιο αντίγραφο.

docs/es/features/playlist-monitor.md

@@ -284,6 +284,12 @@ La página de una vigilancia también muestra:
 
 El id de la vigilancia (`#12`) aparece junto a su nombre, así que dos vigilancias del mismo enlace — dos cuentas que siguen una playlist, por ejemplo — se pueden distinguir.
 
+### Los lanzamientos de un artista
+
+La página de un seguimiento de artista también lista todo su catálogo según la última comprobación: cada lanzamiento que listan YouTube Music, Deezer y MusicBrainz (el mismo álbum de dos fuentes aparece una vez), en álbumes, mixtapes, EPs, sencillos y lanzamientos en vivo, recopilatorios y remixes. Cada uno muestra lo que la biblioteca tiene de él: **Completo** con su número de pistas, **En parte**, **Por descargar**, **Anterior al seguimiento** (un seguimiento con **Solo lanzamientos nuevos** lo saltó), **No seguido** (un tipo o clase que el seguimiento no descarga) o **Desactivado**. Las colaboraciones y los bootlegs tienen su propio filtro y nunca se descargan.
+
+El interruptor junto a un lanzamiento tiene prioridad sobre el seguimiento, como la supervisión por álbum de Lidarr. Activado, lo descarga aunque su tipo no se siga o haya salido antes de empezar el seguimiento, y una comprobación empieza enseguida. Desactivado, deja de descargarlo. Las canciones que ya están en la biblioteca se quedan en ambos casos. **De MusicBrainz, descargar también** elige, solo para este artista, qué clases de lanzamiento que solo MusicBrainz distingue se descargan: mixtapes y bandas sonoras por defecto; álbumes en vivo, recopilatorios, remixes, sesiones de DJ y demos al activarlos.
+
 ## De dónde viene una canción
 
 **De dónde viene** en el menú de una canción (en cualquier lugar de la Biblioteca) dice qué vigilancia la descargó primero, cuándo y con qué proveedor — **Primera comprobación** si llegó con la primera comprobación — y lista todas las vigilancias que la tienen ahora, cada una con su id, dueño (para un admin), cuándo recibió la canción y cómo: **La descargó**, **Ya en la biblioteca** o **Antes del registro**. Es un solo archivo: las vigilancias que comparten una canción apuntan todas a la misma copia.