dustin/Melo
1
0
Fork 0
Code Issues Pull Requests 3 Actions Packages Projects Releases Wiki Activity

UI: Alben sind Kategorien — Reiter Lieder/Kategorie/Kuenstler

Browse Source 
Auf Wunsch von Dustin: seine beste Freundin sortiert ihre Sammlung ueber
das Album-Feld. In Melo ist der Album-Titel deshalb ab jetzt die Kategorie
— sie muss nichts neu machen.

1) Album = Kategorie
- kategorienAusTags(): Album-Titel steht VORN in der Kategorienliste (die
  erste Kategorie bestimmt das Coverbild), Genres dahinter.
- Beide Scans (android_scan + scan_service) tragen ihn ein; von Hand
  gepflegte Kategorien (categoriesEdited) bleiben unberuehrt.
- DB-Schema 9: einmalige Nachruestung bestehender Bibliotheken, damit das
  nicht erst beim naechsten vollstaendigen Scan sichtbar wird (der auf
  Android nur laeuft, wenn sich die Dateianzahl aendert).

2) Reiter: 'Songs/Kuenstler/Alben' -> 'Lieder/Kategorie/Kuenstler'
- Neu: library/category_list.dart mit groupByCategory(); Lieder ohne
  Kategorie sammeln sich am Ende unter "Ohne Kategorie".
- Entfernt: library/album_list.dart, groupByAlbum(), albumArtistLabel() —
  mit dem Alben-Reiter tot geworden. Das Album-FELD bleibt erhalten.

3) YouTube-Downloads ohne Original-Album
- Feld "Kategorie (optional)" im YouTube-Bereich, mit Vorschlaegen aus der
  Bibliothek und freier Eingabe.
- ordneDownloadEin() verwirft nach dem Scan das Album-Tag (yt-dlp leitet es
  aus Kanal/Playlist ab — als Kategorie waere das Unsinn) und setzt
  stattdessen die gewaehlte Kategorie. Beides als "von Hand gesetzt"
  markiert, damit der naechste Scan es nicht zurueckholt.
- MeloDb.songByPath() und MeloDb.verwirfAlbum() neu.
- CategoryService.alleNamen: Kategorienamen ohne zusaetzliche Abfrage —
  ohne das flackerte die Vorschlagsliste und im Widget-Test blieb ein
  Aufraeum-Timer von drift haengen.

295 Tests gruen (19 neue, 1 uebersprungen), flutter analyze ohne Befund.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FpPu4nuKjKKeX1RpdDeX81
This commit is contained in:
Hermes (Server)
2026-08-21 09:36:46 +02:00
co-authored by Claude Opus 5
parent cd79213bb3
commit c7a7a7c458
17 changed files with 726 additions and 157 deletions
Download Patch File Download Diff File Expand all files Collapse all files
lib/downloads/download_einordnung.dart
+36
View File
@@ -0,0 +1,36 @@
import '../library/database.dart';
/// Ordnet einen frisch heruntergeladenen Titel in die Bibliothek ein.
///
/// YouTube-Dateien bringen ein Album-Tag mit, das yt-dlp aus Kanal, Playlist
/// oder Videotitel ableitet. Da der Album-Titel in Melo die Kategorie ist,
/// wäre das Unsinn — es würde für jeden Download eine Kategorie wie
/// „Topic - Various Artists" erzeugen. Das Album wird deshalb verworfen;
/// stattdessen zählt allein die beim Download gewählte [kategorie].
///
/// Ein leerer [kategorie]-Wert lässt den Titel bewusst ohne Kategorie. Beides
/// wird als „von Hand gesetzt" markiert, damit der nächste Bibliotheks-Scan
/// die Tags der Datei nicht wieder hereinholt.
Future<void> ordneDownloadEin(
MeloDb db,
String pfad,
String kategorie,
) async {
final song = await db.songByPath(pfad);
if (song == null) return;
await db.verwirfAlbum(song.id);
final name = kategorie.trim();
await db.setCategories(song.id, name.isEmpty ? const [] : [name],
byUser: true);
}
/// Kategorie-Vorschläge zur Eingabe [eingabe]: alles aus [vorhanden], das die
/// Eingabe enthält. Leere Eingabe zeigt alles.
List<String> kategorieVorschlaege(String eingabe, List<String> vorhanden) {
final suche = eingabe.trim().toLowerCase();
if (suche.isEmpty) return vorhanden;
return [
for (final name in vorhanden)
if (name.toLowerCase().contains(suche)) name,
];
}
lib/downloads/downloads_screen.dart
+54 -1
View File
@@ -5,6 +5,8 @@ import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
import 'package:shared_preferences/shared_preferences.dart';
import '../library/category_service.dart';
import '../library/database.dart';
import '../library/library_service.dart';
import '../player/audio_handler.dart';
import '../services/baka_auth.dart';
@@ -13,6 +15,7 @@ import '../services/navidrome_service.dart';
import '../services/server_neuheiten.dart';
import '../services/yt_download_service.dart';
import '../shared/sub_tabs.dart';
import 'download_einordnung.dart';
import '../shared/theme.dart';
/// Online-Tab: durchsucht den verbundenen Navidrome-Server. Abgespielte
@@ -398,6 +401,9 @@ class _YouTubeBereichState extends State<_YouTubeBereich> {
});
}
/// Kategorie, in die der heruntergeladene Titel wandert. Leer = keine.
final _kategorie = TextEditingController();
Future<void> _setzeCookies(bool an) async {
setState(() => _cookies = an);
final prefs = await SharedPreferences.getInstance();
@@ -407,6 +413,7 @@ class _YouTubeBereichState extends State<_YouTubeBereich> {
@override
void dispose() {
_url.dispose();
_kategorie.dispose();
super.dispose();
}
@@ -454,12 +461,19 @@ class _YouTubeBereichState extends State<_YouTubeBereich> {
return;
}
final db = context.read<MeloDb>();
final kategorie = _kategorie.text;
_url.clear();
setState(() => _meldung = '✅ ${ergebnis.titel} — wird eingelesen …');
// Der MediaStore kennt die Datei jetzt; ein Scan holt sie in die Bibliothek.
await lib.rescan();
// Erst nach dem Scan: vorher gibt es die Songzeile noch nicht. Hier wird
// auch das Album-Tag von YouTube verworfen (siehe ordneDownloadEin).
await ordneDownloadEin(db, pfad, kategorie);
if (mounted) {
setState(() => _meldung = '✅ ${ergebnis.titel} ist in deiner Musik');
setState(() => _meldung = kategorie.trim().isEmpty
? '✅ ${ergebnis.titel} ist in deiner Musik'
: '✅ ${ergebnis.titel} ist in „${kategorie.trim()}“');
}
}
@@ -508,6 +522,8 @@ class _YouTubeBereichState extends State<_YouTubeBereich> {
border: OutlineInputBorder(),
),
),
const SizedBox(height: 12),
_KategorieFeld(controller: _kategorie, aktiv: !dienst.laeuft),
SwitchListTile(
dense: true,
contentPadding: EdgeInsets.zero,
@@ -618,3 +634,40 @@ class _AnmeldeDialogState extends State<_AnmeldeDialog> {
);
}
}
/// Eingabefeld für die Kategorie eines Downloads: schlägt die Kategorien der
/// Bibliothek vor, nimmt aber auch eine neue entgegen.
///
/// Nötig, weil das Album-Tag von YouTube verworfen wird — ohne diese Angabe
/// landet der Titel ohne Kategorie in der Bibliothek.
class _KategorieFeld extends StatelessWidget {
const _KategorieFeld({required this.controller, required this.aktiv});
final TextEditingController controller;
final bool aktiv;
@override
Widget build(BuildContext context) {
final vorhanden = context.watch<CategoryService>().alleNamen;
return Autocomplete<String>(
optionsBuilder: (wert) => kategorieVorschlaege(wert.text, vorhanden),
onSelected: (wert) => controller.text = wert,
fieldViewBuilder: (context, feld, focus, onSubmit) {
// Der Autocomplete führt einen eigenen Controller; seinen Text an
// den unseren durchreichen, damit der Download ihn sieht.
feld.addListener(() => controller.text = feld.text);
return TextField(
controller: feld,
focusNode: focus,
enabled: aktiv,
decoration: const InputDecoration(
labelText: 'Kategorie (optional)',
hintText: 'z. B. Nightcore',
helperText: 'Leer lassen = ohne Kategorie',
border: OutlineInputBorder(),
),
);
},
);
}
}
lib/library/album_list.dart
-69
View File
@@ -1,69 +0,0 @@
import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
import '../shared/cover.dart';
import 'database.dart';
import 'song_grouping.dart';
import 'song_list.dart';
/// Bibliotheks-Tab: Album-Übersicht, gruppiert aus [MeloDb.watchSongs].
class AlbumListScreen extends StatelessWidget {
const AlbumListScreen({super.key});
@override
Widget build(BuildContext context) {
final db = context.read<MeloDb>();
return StreamBuilder<List<Song>>(
stream: db.watchSongs(),
builder: (context, snapshot) {
final songs = snapshot.data ?? const [];
if (songs.isEmpty) {
return const Center(
child: Text('Keine Alben', style: TextStyle(color: Colors.white54)),
);
}
final grouped = groupByAlbum(songs);
final albums = grouped.keys.toList();
return ListView.builder(
itemCount: albums.length,
itemBuilder: (context, i) {
final album = albums[i];
final albumSongs = grouped[album]!;
final coverPath = albumSongs.first.coverPath;
return ListTile(
leading: CoverImage(
artUri: coverPath != null ? Uri.file(coverPath) : null,
size: 48,
radius: 6,
),
title: Text(album, maxLines: 1, overflow: TextOverflow.ellipsis),
subtitle: Text('${albumArtistLabel(albumSongs)} · ${albumSongs.length} Songs',
maxLines: 1, overflow: TextOverflow.ellipsis),
onTap: () => Navigator.push(
context,
MaterialPageRoute(
builder: (_) => _AlbumSongsScreen(album: album, songs: albumSongs),
),
),
);
},
);
},
);
}
}
/// Zeigt alle Songs eines Albums.
class _AlbumSongsScreen extends StatelessWidget {
const _AlbumSongsScreen({required this.album, required this.songs});
final String album;
final List<Song> songs;
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text(album)),
body: SongList(songs),
);
}
}
lib/library/android_scan.dart
+4 -1
View File
@@ -87,7 +87,10 @@ Future<int> scanAndroidMediaStore(
deleted: const Value(false),
));
if (prev?.categoriesEdited != true) {
categories[id] = parseCategories(s.genre);
categories[id] = kategorienAusTags(
album: behalten ? prev!.album : s.album,
genres: parseCategories(s.genre),
);
}
++done;
if (done % 50 == 0 || done == songs.length) {
lib/library/categories.dart
+47
View File
@@ -17,6 +17,22 @@ List<String> parseCategoryList(Iterable<String> raw) {
return _dedupe(raw.expand((e) => e.split(_separators)).map((e) => e.trim()));
}
/// Kategorien eines Titels aus seinen Tags.
///
/// Der **Album-Titel zählt als Kategorie** und steht vorn: viele Sammlungen
/// sind über das Album-Feld sortiert, nicht über das Genre — Alben und
/// Kategorien sind in Melo dieselbe Sache. Die vordere Position ist wichtig,
/// weil die erste Kategorie das Coverbild bestimmt.
List<String> kategorienAusTags({
String? album,
Iterable<String> genres = const [],
}) {
final ausGenre = parseCategoryList(genres);
final albumName = album?.trim() ?? '';
if (albumName.isEmpty) return ausGenre;
return _dedupe([albumName, ...ausGenre]);
}
List<String> _dedupe(Iterable<String> candidates) {
final seen = <String>{};
final result = <String>[];
@@ -27,6 +43,37 @@ List<String> _dedupe(Iterable<String> candidates) {
return result;
}
/// Name für Titel, denen keine Kategorie zugeordnet ist.
const ohneKategorie = 'Ohne Kategorie';
/// Bündelt [songs] nach Kategorie, alphabetisch nach Kategoriename. Ein Titel
/// erscheint unter **jeder** seiner Kategorien; Titel ganz ohne Kategorie
/// sammeln sich unter [ohneKategorie] (immer am Ende, damit die benannten
/// Kategorien oben stehen).
Map<String, List<Song>> groupByCategory(
List<Song> songs,
Map<String, List<String>> categoriesBySong,
) {
final grouped = <String, List<Song>>{};
final ohne = <Song>[];
for (final song in songs) {
final names = categoriesBySong[song.id] ?? const <String>[];
if (names.isEmpty) {
ohne.add(song);
continue;
}
for (final name in names) {
grouped.putIfAbsent(name, () => []).add(song);
}
}
final keys = grouped.keys.toList()
..sort((a, b) => a.toLowerCase().compareTo(b.toLowerCase()));
return {
for (final key in keys) key: grouped[key]!,
if (ohne.isNotEmpty) ohneKategorie: ohne,
};
}
/// Ermittelt je Kategorie ein Coverbild: das erste vorhandene Cover unter den
/// Songs der Kategorie, nach Titel geordnet — damit dieselbe Bibliothek immer
/// dasselbe Bild ergibt. Kategorien ohne jedes Cover fehlen im Ergebnis.
lib/library/category_list.dart
+83
View File
@@ -0,0 +1,83 @@
import 'package:flutter/material.dart';
import 'package:provider/provider.dart';
import '../settings/app_settings.dart';
import '../shared/cover.dart';
import 'categories.dart';
import 'category_service.dart';
import 'database.dart';
import 'song_list.dart';
/// Bibliotheks-Reiter „Kategorie": alle Kategorien der Bibliothek.
///
/// Ersetzt den früheren Alben-Reiter — der Album-Titel eines Liedes **ist**
/// in Melo seine Kategorie (siehe [kategorienAusTags]). Wer seine Sammlung
/// über das Album-Feld sortiert hat, findet sie hier unverändert wieder.
class CategoryListScreen extends StatelessWidget {
const CategoryListScreen({super.key});
@override
Widget build(BuildContext context) {
final db = context.read<MeloDb>();
final categories = context.watch<CategoryService>();
final settings = context.watch<AppSettings>();
return StreamBuilder<List<Song>>(
stream: db.watchSongs(),
builder: (context, snapshot) {
final songs = snapshot.data ?? const <Song>[];
if (songs.isEmpty) {
return const Center(
child: Text('Keine Kategorien',
style: TextStyle(color: Colors.white54)),
);
}
final grouped = groupByCategory(
songs,
{for (final s in songs) s.id: categories.of(s.id)},
);
final namen = grouped.keys.toList();
return ListView.builder(
itemCount: namen.length,
itemBuilder: (context, i) {
final name = namen[i];
final lieder = grouped[name]!;
final cover = categories.coverFor(lieder.first,
groupByCategory: settings.groupCoversByCategory);
return ListTile(
leading: CoverImage(
artUri: cover != null ? Uri.file(cover) : null,
size: 48,
radius: 6,
),
title: Text(name, maxLines: 1, overflow: TextOverflow.ellipsis),
subtitle: Text('${lieder.length} Lieder'),
onTap: () => Navigator.push(
context,
MaterialPageRoute(
builder: (_) =>
_KategorieLiederScreen(name: name, songs: lieder),
),
),
);
},
);
},
);
}
}
/// Zeigt alle Lieder einer Kategorie.
class _KategorieLiederScreen extends StatelessWidget {
const _KategorieLiederScreen({required this.name, required this.songs});
final String name;
final List<Song> songs;
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(title: Text(name)),
body: SongList(songs),
);
}
}
lib/library/category_service.dart
+14
View File
@@ -43,6 +43,20 @@ class CategoryService extends ChangeNotifier {
Future<List<String>> allNames() => _db.allCategoryNames();
/// Alle vergebenen Kategorien, alphabetisch — aus dem ohnehin beobachteten
/// Bestand, ohne zusätzliche Abfrage. Für Oberflächen, die die Liste beim
/// Bauen brauchen und nicht auf eine Antwort warten sollen.
List<String> get alleNamen {
final namen = <String, String>{};
for (final liste in _byId.values) {
for (final name in liste) {
namen.putIfAbsent(name.toLowerCase(), () => name);
}
}
final sortiert = namen.keys.toList()..sort();
return [for (final k in sortiert) namen[k]!];
}
void _recompute() {
_covers = categoryCovers(_allSongs, _byId);
notifyListeners();
lib/library/database.dart
+56 -1
View File
@@ -1,6 +1,7 @@
import 'dart:io';
import 'package:drift/drift.dart';
import 'package:flutter/foundation.dart' show visibleForTesting;
import 'package:drift/native.dart';
import 'package:path/path.dart' as p;
import 'package:path_provider/path_provider.dart';
@@ -129,7 +130,7 @@ class MeloDb extends _$MeloDb {
MeloDb([QueryExecutor? executor]) : super(executor ?? _open());
@override
int get schemaVersion => 8;
int get schemaVersion => 9;
@override
MigrationStrategy get migration => MigrationStrategy(
@@ -160,6 +161,14 @@ class MeloDb extends _$MeloDb {
if (from < 8) {
await m.addColumn(songs, songs.cloudId);
}
if (from < 9) {
// Album-Titel gelten ab jetzt als Kategorie (siehe
// kategorienAusTags). Ohne diese Nachrüstung bekämen bestehende
// Bibliotheken das erst beim nächsten vollständigen Scan zu
// sehen — der auf Android nur läuft, wenn sich die Anzahl der
// Dateien ändert.
await _ergaenzeAlbumKategorien();
}
},
);
@@ -448,6 +457,52 @@ class MeloDb extends _$MeloDb {
));
}
/// Der Song mit genau diesem Dateipfad, oder `null`.
Future<Song?> songByPath(String path) =>
(select(songs)..where((s) => s.path.equals(path))).getSingleOrNull();
/// Verwirft das Album-Tag eines Titels und markiert ihn als von Hand
/// bearbeitet, damit der nächste Scan es nicht wieder hereinholt.
/// Für YouTube-Downloads: deren Album-Tag ist keine sinnvolle Kategorie.
Future<void> verwirfAlbum(String songId) async {
await (update(songs)..where((s) => s.id.equals(songId))).write(
const SongsCompanion(
album: Value(null),
metadataEdited: Value(true),
),
);
}
/// Nur für Tests: führt die Nachrüstung aus Schema 9 auf einer bereits
/// angelegten Datenbank aus.
@visibleForTesting
Future<void> ergaenzeAlbumKategorienFuerTest() => _ergaenzeAlbumKategorien();
/// Trägt für jeden Titel seinen Album-Namen als **erste** Kategorie nach.
/// Von Hand gepflegte Kategorien (`categoriesEdited`) bleiben unberührt.
Future<void> _ergaenzeAlbumKategorien() async {
const betroffen = "SELECT id, TRIM(album) AS album_name FROM songs "
"WHERE album IS NOT NULL AND TRIM(album) <> '' "
"AND categories_edited = 0";
// 1) War der Album-Name schon Kategorie, kommt er gleich wieder vorn
// dazu — den alten Eintrag deshalb entfernen.
await customStatement(
'DELETE FROM song_categories WHERE EXISTS ('
'SELECT 1 FROM ($betroffen) b '
'WHERE b.id = song_categories.song_id AND b.album_name = song_categories.name)',
);
// 2) Platz an Position 0 schaffen.
await customStatement(
'UPDATE song_categories SET position = position + 1 '
'WHERE song_id IN (SELECT id FROM ($betroffen))',
);
// 3) Album-Name als erste Kategorie setzen.
await customStatement(
'INSERT INTO song_categories (song_id, name, position) '
'SELECT id, album_name, 0 FROM ($betroffen)',
);
}
// === Cloud-Sync ===
/// Verknüpft einen Titel des Geräts mit seinem Gegenstück in der Cloud.
Future<void> setCloudId(String songId, String cloudId) async {
lib/library/my_music_screen.dart
+6 -6
View File
@@ -8,7 +8,7 @@ import '../shared/sort_store.dart';
import '../shared/sub_tabs.dart';
import '../shared/sortable_song_list.dart';
import '../shared/theme.dart';
import 'album_list.dart';
import 'category_list.dart';
import 'artist_list.dart';
import 'database.dart';
import 'library_service.dart';
@@ -17,7 +17,7 @@ import 'permissions.dart';
import 'song_list.dart';
/// Startbildschirm: Kopfzeile mit Einstellungen/Suche/Musikerkennung,
/// Schnellzugriffe, Unterreiter (Songs/Künstler/Alben) und darunter der
/// Schnellzugriffe, Unterreiter (Lieder/Kategorie/Künstler) und darunter der
/// jeweilige Inhalt. Bewusst ohne AppBar — die Kopfzeile ist Teil des Inhalts.
class MyMusicScreen extends StatefulWidget {
const MyMusicScreen({super.key, this.onSearchTap, this.onFavoritesTap});
@@ -33,7 +33,7 @@ class MyMusicScreen extends StatefulWidget {
}
class _MyMusicScreenState extends State<MyMusicScreen> {
/// 0 = Songs, 1 = Künstler, 2 = Alben.
/// 0 = Lieder, 1 = Kategorie, 2 = Künstler.
int _subTab = 0;
@override
@@ -85,14 +85,14 @@ class _MyMusicScreenState extends State<MyMusicScreen> {
),
_QuickAccessRow(onFavoritesTap: widget.onFavoritesTap),
SubTabs(
labels: const ['Songs', 'Künstler', 'Alben'],
labels: const ['Lieder', 'Kategorie', 'Künstler'],
index: _subTab,
onChanged: (i) => setState(() => _subTab = i),
),
Expanded(
child: switch (_subTab) {
1 => const ArtistListScreen(),
2 => const AlbumListScreen(),
1 => const CategoryListScreen(),
2 => const ArtistListScreen(),
_ => StreamBuilder<List<Song>>(
stream: db.watchSongs(),
builder: (context, snapshot) {
lib/library/scan_service.dart
+4 -1
View File
@@ -107,7 +107,10 @@ Future<int> scanFolders(
gainDb: Value(gainDb),
));
if (prev?.categoriesEdited != true) {
categories[id] = parseCategoryList(meta?.genres ?? const []);
categories[id] = kategorienAusTags(
album: behalten ? prev!.album : meta?.album,
genres: meta?.genres ?? const [],
);
}
++done;
if (done % 50 == 0 || done == files.length) {
lib/library/song_grouping.dart
-14
View File
@@ -1,7 +1,6 @@
import 'database.dart';
const unbekannterKuenstler = 'Unbekannt';
const unbekanntesAlbum = 'Unbekanntes Album';
/// Gruppiert [songs] nach Künstler (fehlender Künstler → [unbekannterKuenstler]),
/// alphabetisch nach Künstlername sortiert.
@@ -9,19 +8,6 @@ Map<String, List<Song>> groupByArtist(List<Song> songs) {
return _groupBy(songs, (s) => s.artist, unbekannterKuenstler);
}
/// Gruppiert [songs] nach Album (fehlendes Album → [unbekanntesAlbum]),
/// alphabetisch nach Albumname sortiert.
Map<String, List<Song>> groupByAlbum(List<Song> songs) {
return _groupBy(songs, (s) => s.album, unbekanntesAlbum);
}
/// Künstler-Beschriftung für ein Album: der gemeinsame Künstler, falls alle
/// Songs im Album vom selben Künstler stammen, sonst "Verschiedene Interpreten".
String albumArtistLabel(List<Song> songs) {
final artists = songs.map((s) => s.artist ?? unbekannterKuenstler).toSet();
return artists.length == 1 ? artists.first : 'Verschiedene Interpreten';
}
Map<String, List<Song>> _groupBy(
List<Song> songs,
String? Function(Song) keyOf,