Files
wiki/Catalogue-Self-Hosted/apps/app-musicseerr.md
T
2026-06-09 18:40:21 +02:00

151 lines
8.2 KiB
Markdown

---
title: Musicseerr
created: 2026-06-07
updated: 2026-06-07
type: app
tags: [catalogue, music, request-manager, lidarr, musicbrainz, overseerr-fork, typescript]
confidence: medium
contested: false
sources:
- https://selfh.st/apps/?tag=music
- https://github.com/clarkemedia/musicseerr
---
# 🎶 Musicseerr
> Fork d'**Overseerr/Jellyseerr** réorienté musique : un gestionnaire de **demandes musicales** pour [[app-lidarr]], exploitant **MusicBrainz** (artistes, albums, discographies) plutôt que TMDB (films, séries). UI façon Spotify (vert), pensée pour familles/groupes.
| Métadonnée | Valeur |
| :--- | :--- |
| **Site web** | https://github.com/clarkemedia/musicseerr |
| **GitHub** | https://github.com/clarkemedia/musicseerr |
| **License** | MIT |
| **Langage** | TypeScript (Next.js) + Go (backend Seerr) |
| **Étoiles** | 14 ⭐ |
| **Dernière MAJ** | 2026-05 (v0.0.7) |
| **Catégorie** | [[cat-music]] |
## Description
Musicseerr est né d'un constat de l'auteur (Clarke117) : *« Overseerr/Jellyseerr est construit pour les films et la TV. Musicseerr adapte ce framework pour gérer les besoins spécifiques de la musique — artistes, albums, discographies. »* Concrètement, c'est un **fork thématique** de la famille *Seerr* (Overseerr → Jellyseerr → Seerr) qui remplace toute la couche métadonnées *« movie/series »* par une couche *« music/artist/album »* branchée sur **MusicBrainz** et **Cover Art Archive**.
Le use case : vous avez [[app-lidarr]] qui gère la qualité de votre bibliothèque musicale, mais vous voulez une **interface utilisateur jolie** (type Netflix/Spotify) pour que votre famille puisse **demander** des artistes ou albums sans toucher à Lidarr. Musicseerr joue exactement ce rôle : browse MusicBrainz → chercher un artiste → voir la discographie complète → soumettre une *request* → MusicSeerr la transmet à Lidarr via son API → Lidarr cherche/télécharge/indexe.
L'UI est clairement inspirée de Spotify (gradient vert `#1ED760 → #1DB954`, logo play-button, navigation latérale par genres) — un choix esthétique malin pour rester dans l'imaginaire « app de musique ». Le repo est jeune (fork publié mi-2025, version 0.0.7 en mai 2026), avec un **statut alpha** assumé : « fonctionnel pour la recherche MusicBrainz et la connectivité Lidarr, mais plusieurs aspects à finaliser » (cf. README : filtres bootlegs/live, intégration Cover Art Archive, payloads API à débugger).
**Différenciation vs l'écosystème *arr*** : [[app-lidarr]] est puissant mais austère (UI admin, pas user-friendly). [[app-jellyseerr]] / Overseerr sont parfaits pour les films mais gèrent mal la musique. **Headphones** (projet historique) a été abandonné. **Musicseerr** se positionne comme le chaînon manquant : un *« Overseerr de la musique »* qui s'intègre au *arr stack* existant. C'est encore tôt pour le recommander en prod, mais l'idée est solide et le code bénéficie de la base mature de Seerr/Jellyseerr.
## Installation
### Docker Compose (recommandé)
```yaml
# docker-compose.yml
services:
musicseerr:
image: ghcr.io/clarkemedia/musicseerr:latest
container_name: musicseerr
restart: unless-stopped
ports:
- "5757:5757" # port ZimaOS par défaut (coexiste avec Jellyseerr 5055)
environment:
- TZ=Europe/Paris
- LOG_LEVEL=info
- CONFIG_DIR=/app/config
volumes:
- ./musicseerr-config:/app/config # settings, db, logs
# premier lancement : setup wizard sur :5757
```
### Compose avec Postgres (recommandé en prod)
```yaml
# compose.postgres.yaml
services:
postgres:
image: postgres:16-alpine
container_name: musicseerr-db
environment:
POSTGRES_USER: musicseerr
POSTGRES_PASSWORD: changeme
volumes:
- musicseerr_db:/var/lib/postgresql/data
restart: unless-stopped
musicseerr:
image: ghcr.io/clarkemedia/musicseerr:latest
depends_on:
- postgres
ports:
- "5757:5757"
environment:
- DATABASE_URL=postgres://musicseerr:changeme@postgres:5432/musicseerr
volumes:
- ./musicseerr-config:/app/config
volumes:
musicseerr_db:
```
### Installation manuelle (dev)
```bash
git clone https://github.com/clarkemedia/musicseerr
cd musicseerr
yarn install
yarn dev # mode dev
# build prod : yarn build && yarn start
```
## Configuration
- **Premier lancement** : setup wizard web sur `:5757` — créer le compte admin, configurer la connexion à [[app-lidarr]] (URL + API key), le provider de métadonnées (MusicBrainz par défaut, gratuit, pas de credential).
- **Lidarr** : récupérer l'API key dans Lidarr *Settings → General → API Key*. L'URL doit être joignable depuis le conteneur (réseau Docker partagé).
- **MusicBrainz** : pas d'auth requise pour la recherche basique, rate-limited à 1 req/s par IP. Pour du volume, demander un *User-Agent* personnalisé (cf. leur politique).
- **Thème** : palette verte Spotify par défaut, le logo et la sidebar sont déjà rebrandés.
- **Authentification multi-users** : supporte les comptes locaux, l'intégration **Plex/Jellyfin/Emby** est conservée du fork Seerr (permet de se connecter avec son compte media).
- **Notifications** : Discord, Telegram, webhook, email (hérités de Seerr).
## Alternatives
### Open Source
- **[[app-lidarr]]** — backend de gestion musicale (le « moteur »), pas une UI de request.
- **[[app-jellyseerr]] / Overseerr** — équivalent movies/series, pas adapté à la musique.
- **Headphones** — ancien *request manager* musical (Python), **abandonné depuis 2018**, ne pas utiliser.
- **Lidarr + son UI native** — utilisable directement, mais moins user-friendly.
- **Requestrr** — autre request manager *arr, orienté films.
- **Ombi** — équivalent multi-types (films + séries + musique), plus généraliste que Musicseerr.
### Propriétaires (ce que Musicseerr remplace)
- **Spotify Family** — interface de découverte + playlist collaborative, mais pas de self-hosted.
- **Apple Music Family Sharing** — idem, fermé.
- **Last.fm Pro** — scrobbling + reco, pas de request manager.
- **Plex Pass + Plex Requests** — plugin, pas spécifique musique.
- **Notion / Airtable** comme « liste de souhaits musicale » — bricolage courant, sans intégration Lidarr.
## Sécurité
- **Statut alpha** : **ne pas déployer en prod critique** sans tests préalables. Plusieurs fonctionnalités sont documentées comme « à finaliser » par l'auteur.
- **Bus factor 1** : mainteneur unique (Clarke117), fork récent — risque d'abandon. Le bon côté : c'est un fork d'une base mature (Seerr/Overseerr), donc même sans updates upstream, le code reste fonctionnel pour les features core.
- **API Lidarr** : la clé API Lidarr donne **accès total** à votre instance Lidarr (recherche, download, modification qualité profiles). À stocker de manière chiffrée dans `./musicseerr-config`.
- **Pas d'auth par défaut sur `:5757`** pendant le setup — surveiller les logs pour le message « admin créé », mettre immédiatement derrière [[app-traefik]] + [[app-authentik]] ou au minimum un basic-auth.
- **Multi-utilisateurs** : la première inscription ouverte peut être exploitée pour créer un compte admin concurrent. Désactiver l'inscription libre après création du compte admin (`Settings → Users → Permissions`).
- **Metadata externe (MusicBrainz)** : pas de credential, mais votre IP de serveur apparaît dans leurs logs. RGPD : minimiser les appels en cacheant.
- **MIT license** : plus permissif qu'AGPL, pas d'obligation de re-publication en fork.
## Ressources
- Repository : https://github.com/clarkemedia/musicseerr
- Seerr (base) : https://github.com/seerr-team/seerr
- [[app-lidarr]] (intégration) : https://lidarr.audio/
- MusicBrainz API : https://musicbrainz.org/doc/MusicBrainz_API
- Reddit de lancement : https://www.reddit.com/r/Overseerr/comments/1sfyk9z/
## Pages Liées
- [[cat-music]] — catégorie parente
- [[app-lidarr]] — backend d'acquisition indispensable
- [[app-jellyseerr]] — équivalent movies/series (même famille)
- [[app-funkwhale]] — serveur de streaming musical
- [[app-jellyfin]] — alternative serveur
- [[app-traefik]] — reverse proxy
- [[app-authentik]] — SSO
- [[recettes-docker-compose]] — templates
- [[securisation-home-lab]] — bonnes pratiques