Files
musicseerr/backend/api/v1/routes/lidarr_request.py
T
shaunrd0 23c9125ad8
Backend CI / Lint (push) Waiting to run
Backend CI / Tests (push) Waiting to run
Personal fork of habirabbu/musicseerr — multi-instance + inline downloads + lidarr-request
Squashes 26 incremental fork commits (Apr–May 2026) onto upstream main as a single
diff for cleaner cross-fork comparison. Original history preserved on the
pre-squash-backup tag locally.

Feature additions
─────────────────

• Inline single-track download via yt-dlp-worker proxy
  New routes: POST /api/v1/track-download/search (source: youtube | spotify),
  POST /api/v1/track-download, GET /api/v1/track-download/{id}. Frontend
  TrackDownloadButton in album track list AND popular-songs row, with a per-button
  source picker. Per-user rate limits live in the worker's SQLite store. On
  completion the backend fires Lidarr RefreshArtist + Plex library refresh +
  cache invalidation, and the popular-songs list auto-refreshes.

• Per-instance library pinning via MUSICSEERR_LIBRARY env
  Backend stamps the library label server-side (music / music-personal /
  music-shared); clients cannot override. Drives an instance-segregated
  deployment of three musicseerr containers sharing one source tree.

• Lidarr-request flow (single-track requests via Lidarr indexers)
  New routes: POST /api/v1/lidarr-request, GET /api/v1/lidarr-request/status.
  Per-album asyncio.Lock keyed on album_mbid so rapid-clicks on the same album
  serialize correctly. Cross-release track matcher with foreignTrackId →
  foreignRecordingId → position+disc → exact-title → substring fallback chain,
  evaluated per release (recording UUIDs frequently differ between album,
  single, and deluxe edition releases of the same song). Flips
  artist.monitored = True on request so Lidarr's WantedAlbums query reaches
  the track. Full Lidarr-chain gate (artist AND album AND track) for the
  status endpoint to avoid false-positive REQUESTED display. Persistent UI
  state so button icons survive refresh and cross-album navigation.

• Privacy: show_now_playing toggle in Settings → Home
  Default off. Plex /status/sessions returns active audio sessions across the
  whole server with no library-section filter, so a shared instance leaks
  every household member's listening activity. The merged store still emits
  the user's local MusicSeerr playback bar; only server-derived sessions
  (Plex / Jellyfin / Navidrome) are gated.

• Per-button visibility prefs for the track-row action cluster
  Settings → Preferences → Download Options / Playback Buttons. Per-context
  (popular_songs / album_page) force-off flags layered on top of the existing
  source-availability gate.

• UX: wrap action cluster on mobile, hide LidarrRequestButton in tight
  layouts, cross-album status-leak fix in AlbumTrackList ($effect keyed on
  album.musicbrainz_id to rebuild lookup; map keyed by
  "{albumMbid}:{position}:{disc}").

Test coverage
─────────────

Backend pytest: full suite green (2031/2031 as of squash). New: schema-default
tests for HomeSettings, lidarr_request_service cross-release matcher
regression test, singleton-registry expected-count bump to 59. Frontend
vitest: SettingsHome.svelte.spec covers new toggle, nowPlayingSessions
.svelte.spec covers the privacy gate (no fetch when off; fetches when on).
2026-05-29 23:55:54 +00:00

53 lines
1.8 KiB
Python

"""Single-track Lidarr request API. Fork-only addition.
Distinct from track_download (yt-dlp-worker proxy). This route asks the
configured Lidarr instance to add the album and grab JUST the requested
track via its native indexer pipeline, relying on the track-monitored
fork to gate the import so siblings don't land on disk.
Requires LIDARR_URL pointed at a fork instance (currently
lidarr-shared on gnat:8688).
"""
from __future__ import annotations
from fastapi import APIRouter, Depends, Query
from api.v1.schemas.lidarr_request import (
LidarrRequestAccepted,
LidarrRequestRequest,
LidarrRequestStatusResponse,
)
from core.dependencies import get_lidarr_request_service
from infrastructure.msgspec_fastapi import MsgSpecBody, MsgSpecRoute
from services.lidarr_request_service import LidarrRequestService
router = APIRouter(
route_class=MsgSpecRoute,
prefix="/lidarr-request",
tags=["lidarr-request"],
)
@router.post("", response_model=LidarrRequestAccepted, status_code=202)
async def request_track_via_lidarr(
body: LidarrRequestRequest = MsgSpecBody(LidarrRequestRequest),
service: LidarrRequestService = Depends(get_lidarr_request_service),
) -> LidarrRequestAccepted:
return await service.request_track(
album_mbid=body.album_mbid,
track_mbid=body.track_mbid,
artist_mbid=body.artist_mbid,
track_position=body.track_position,
disc_number=body.disc_number,
track_title=body.track_title,
)
@router.get("/status", response_model=LidarrRequestStatusResponse)
async def get_lidarr_request_status(
album_mbid: str = Query(..., description="Album MusicBrainz release-group ID"),
service: LidarrRequestService = Depends(get_lidarr_request_service),
) -> LidarrRequestStatusResponse:
return await service.get_status(album_mbid)