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

8.2 KiB

title, created, updated, type, tags, confidence, contested, sources
title created updated type tags confidence contested sources
Musicseerr 2026-06-07 2026-06-07 app
catalogue
music
request-manager
lidarr
musicbrainz
overseerr-fork
typescript
medium false
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é)

# 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)

# 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)

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

Pages Liées