dschlueter
d91eb36007
scanner: nicht in Unterordner wenn Root Audio-Dateien enthält (verhindert Doppel-Scan bei versehentlichen Unterordner-Kopien); nur Disc-Ordner (CD1, Disc 2…) werden bei Multi-CD-Alben rekursiert. hint_extractor: M3U/Playlist-Dateien als Track-Reihenfolge-Quelle; BOM- Bereinigung; Tracklist-Matching auch per Titel (nicht nur per Nummer); tracknumber=0 wird als 'keine Nummer' gewertet. metadata_resolver: sequenzielle Fallback-Nummerierung (1,2,3…) für Tracks ohne Tracknummer — verhindert '00'-Präfix beim --rename; dir_artist hat Vorrang vor 'Various Artists'-Heuristik; LLM darf bei Konfidenz <0.3 auch bestehende Werte korrigieren (Tippfehler im Verzeichnisnamen). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
80 lines
2.3 KiB
Python
80 lines
2.3 KiB
Python
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass, field
|
|
from pathlib import Path
|
|
from typing import Optional, List, Dict
|
|
|
|
|
|
AUDIO_EXTENSIONS = {
|
|
".mp3", ".flac", ".m4a", ".aac", ".ogg", ".opus",
|
|
".wav", ".wma", ".aiff", ".ape",
|
|
}
|
|
IMAGE_EXTENSIONS = {".jpg", ".jpeg", ".png", ".webp", ".bmp", ".gif"}
|
|
TRACKLIST_EXTENSIONS = {".txt", ".htm", ".html", ".nfo"}
|
|
PLAYLIST_EXTENSIONS = {".m3u", ".m3u8", ".pls"}
|
|
|
|
|
|
@dataclass
|
|
class ScannedFile:
|
|
path: Path
|
|
kind: str # "audio" | "image" | "tracklist" | "playlist" | "other"
|
|
|
|
|
|
@dataclass
|
|
class AlbumScan:
|
|
album_dir: Path
|
|
audio_files: List[Path] = field(default_factory=list)
|
|
image_files: List[Path] = field(default_factory=list)
|
|
tracklist_files: List[Path] = field(default_factory=list)
|
|
playlist_files: List[Path] = field(default_factory=list) # .m3u / .m3u8 / .pls
|
|
other_files: List[Path] = field(default_factory=list)
|
|
|
|
|
|
@dataclass
|
|
class TrackHints:
|
|
path: Path
|
|
track_number: Optional[int] = None
|
|
disc_number: Optional[int] = None
|
|
title: Optional[str] = None
|
|
artist: Optional[str] = None
|
|
duration: Optional[float] = None
|
|
existing_tags: Dict[str, str] = field(default_factory=dict)
|
|
|
|
|
|
@dataclass
|
|
class AlbumHints:
|
|
album_dir: Path
|
|
dir_artist: Optional[str] = None
|
|
dir_album: Optional[str] = None
|
|
dir_year: Optional[str] = None
|
|
tracklist_text: Optional[str] = None # merged text from all tracklist files
|
|
cover_images: List[Path] = field(default_factory=list)
|
|
tracks: List[TrackHints] = field(default_factory=list)
|
|
|
|
|
|
@dataclass
|
|
class TrackProposal:
|
|
path: Path
|
|
title: str
|
|
artist: str
|
|
track_number: Optional[int]
|
|
disc_number: Optional[int]
|
|
new_filename: Optional[str] = None # only set when --rename is active
|
|
mbid: Optional[str] = None
|
|
|
|
|
|
@dataclass
|
|
class AlbumProposal:
|
|
album_dir: Path
|
|
album: str
|
|
albumartist: str
|
|
date: Optional[str]
|
|
genre: Optional[str]
|
|
label: Optional[str]
|
|
mbid: Optional[str] # MusicBrainz release ID
|
|
cover_path: Optional[Path] # resolved local or downloaded cover
|
|
cover_source: Optional[str] # "local" | "musicbrainz" | "discogs"
|
|
tracks: List[TrackProposal]
|
|
confidence: float
|
|
sources: List[str] = field(default_factory=list)
|
|
notes: List[str] = field(default_factory=list)
|