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

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
-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),
);
}
}
+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) {
+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.
+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),
);
}
}
+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();
+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 {
+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) {
+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) {
-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,