Adolar Taggster

Teil des Adolar Universums · adolar.html · adolartaggster@polze.net

Installation

EXE (empfohlen)

Die Adolar Taggster (AdolarTaggster.exe) von der Releases-Seite herunterladen und doppelklicken — keine weitere Installation nötig.

Aus dem Quellcode

pip install PyQt6 mutagen requests Pillow librosa send2trash
python tagger.py

Windows Explorer Integration

Unter Tools → Einstellungen → Windows Explorer lässt sich optional ein Rechtsklick-Eintrag „Mit Adolar Taggster öffnen" für Ordner hinzufügen (kein Installer, keine Admin-Rechte nötig). Auf Windows 11 erscheint er ggf. unter „Weitere Optionen anzeigen". Öffnet Taggster bereits eine Instanz, wird der gewählte Ordner an das offene Fenster weitergereicht statt eine zweite Instanz zu starten.

Schnellstart

Explorer

Der Explorer-Baum links zeigt Schnellzugriff-Ordner oben und darunter den vollständigen Verzeichnisbaum.

Navigation

• Einfachklick auf einen Ordner klappt ihn auf oder zu.
• Doppelklick auf einen Album-Ordner startet den MP3-Scan (läuft im Hintergrund, UI bleibt reaktionsfähig).
• Während des Scans erscheint ein ✕ Abbrechen-Button in der Toolbar.

Schnellzugriff

Oben im Explorer stehen feste Ordner (Musik, Downloads, Desktop, Dokumente, Videos) sowie selbst angelegte Favoriten (⭐). Ein Klick springt direkt zu diesem Ordner im Baum.

Rechtsklick-Menü

• ⭐ Zu Favoriten hinzufügen / entfernen — Favoriten erscheinen sofort im Schnellzugriff.
• 🗑 In Papierkorb löschen — nach Bestätigung wird der Ordner in den Windows-Papierkorb verschoben und der Baum aktualisiert.

Dateiliste

Nach dem Doppelklick auf einen Ordner erscheinen alle gefundenen MP3s in der Tabelle — sortiert nach Album, dann nach Tracknummer (natürliche Sortierung).

Spalten

Rechtsklick auf eine Spaltenüberschrift öffnet ein Menü zum Ein-/Ausblenden. Standardmäßig sichtbar: 🖼, Track, Dateiname, Künstler, Album, Titel, Jahr, Genre, Dauer, Album Artist, BPM. Optional (Standard: aus): Bitrate, Kommentar, Label, Disc#.

Spalten können per Drag & Drop in der Überschrift umsortiert werden. Layout und Sichtbarkeit bleiben über Neustarts erhalten.

Auswahl & Rechtsklick

• Alle / Keine in der Toolbar für Schnellauswahl.
• Doppelklick auf eine Zeile öffnet den Tag-Editor.
• Rechtsklick → 🏷 Tag bearbeiten — bei einer Datei: vollständiger Editor; bei mehreren: Batch-Editor.

Cover-Panel

Links unten im Explorer-Bereich werden zwei Cover nebeneinander angezeigt:

Falls eine folder.jpg existiert aber kein Tag-Cover vorhanden ist, erscheint der Button folder.jpg als Tag-Cover setzen — ein Klick schreibt das Bild als APIC-Frame in alle markierten Dateien.

Toolbar

Discogs-Suche

Der Suchdialog öffnet sich mit Künstler, Album und Jahr aus den Tags der ersten markierten Datei vorausgefüllt. Die Suche startet automatisch.

• ★ Master-Releases erscheinen gold und fett — sie enthalten die vollständige Referenz-Trackliste.
• Ein Einfachklick auf ein Ergebnis lädt Trackanzahl, Gesamtspielzeit und Cover-Status.
• Lade Album! oder Doppelklick öffnet den TrackMatch-Dialog.
• Künstler-Disambiguierungsnummern wie Artist (2) werden automatisch entfernt.

Bei beiden Suchen (Discogs und MusicBrainz) wird das Künstlerfeld automatisch anhand der bereits vorhandenen Tags vorbelegt: Zeigt der Album-Artist einer der markierten Dateien schon „Various" o.ä., oder haben die markierten Tracks unterschiedliche Künstler, wird als erkannte Compilation direkt mit „Various Artists" statt dem Künstler der ersten Datei gesucht.

MusicBrainz-Suche

Alternative zu Discogs — nützlich, wenn ein Release dort nicht gelistet ist. Öffnet sich ebenfalls mit Künstler/Album/Jahr vorausgefüllt (inkl. automatischer Compilation-Erkennung, siehe oben) und startet die Suche automatisch. Ergebnisse landen wie bei Discogs im TrackMatch-Dialog.

Originaljahr-Suche

Sucht für die markierten Tracks über MusicBrainz das ursprüngliche Erscheinungsjahr der Aufnahme (nicht das der aktuellen Edition) und schlägt es als Original-Jahr (TDOR) vor — praktisch bei Compilations wie „Now Yearbook '91", deren eigenes Erscheinungsjahr vom Jahr der Originalsongs abweicht.

• Dateien mit bereits gesetztem Original-Jahr werden standardmäßig übersprungen. Sind welche darunter, fragt ein Dialog vorab nach, ob diese trotzdem erneut abgefragt werden sollen — die Wahl bleibt für den Rest der laufenden Taggster-Sitzung erhalten, ist nach einem Neustart aber wieder zurückgesetzt.
• Der Fortschritt (aktuell verarbeitete Datei, Balken in der Statusleiste) wird während der Suche live angezeigt.
• Verbindungsfehler und Serverüberlastung (503) werden automatisch mehrfach mit Wartezeit wiederholt, bevor ein Treffer als fehlgeschlagen markiert wird.
• Vor dem Schreiben erscheint ein Review-Dialog: pro Datei Künstler, Titel, aktuelles Original-Jahr, MusicBrainz-Treffer und Status — nur angehakte Zeilen werden tatsächlich geschrieben.

TrackMatch-Dialog

Zeigt lokale Dateien (links) und die Discogs-Trackliste (rechts) nebeneinander.

Zuordnung anpassen

• Klick auf die Dateinamen-Spalte → ▲/▼ verschiebt lokale Dateien.
• Klick auf die Discogs-Spalte → ▲/▼ verschiebt Discogs-Tracks.
• Fehlende Dateien erscheinen als Datei nicht gefunden! in Rot.

Compilation-Alben

Enthält die Discogs-Trackliste Einträge im Format Titel /// Künstler, wird die Compilation-Option automatisch aktiviert: Titel und Track-Künstler werden getrennt geschrieben, Album Artist wird auf Various Artists gesetzt.

Cover per Drag & Drop

Ein Bild aus dem Browser oder dem Explorer kann direkt in das Cover-Feld gezogen werden. Der Button 🔍 Suche Cover Bild öffnet eine Google-Bildersuche mit Künstler + Album + Jahr.

Tag-Editor

Einzelne Datei

Doppelklick auf eine Zeile oder Rechtsklick → Tag bearbeiten öffnet den vollständigen Editor mit allen vorhandenen Werten. Nach dem Klick auf Speichern wird die Zeile in der Dateiliste aktualisiert.

Mehrere Dateien (Batch)

Mehrere Dateien markieren und dann rechtsklicken → Tag bearbeiten. Alle Felder zeigen den Platzhalter <beibehalten>. Nur ausgefüllte Felder werden geschrieben. Vor dem Speichern erscheint eine Bestätigung mit einer Übersicht aller Änderungen.

Original-Jahr (TDOR)

Zusätzlich zu Jahr (TDRC) gibt es das Feld Original-Jahr (TDOR) — für Fälle, in denen das Erscheinungsjahr der Edition vom Erscheinungsjahr des Original-Songs abweicht, z.B. bei Compilations wie „Now Yearbook '91" (Compilation von 2025, Songs von 1991). In beiden Editoren editierbar; im Batch-Editor lässt sich so das Original-Jahr für alle markierten Tracks einer Compilation auf einmal setzen. Auch als optionale (standardmäßig ausgeblendete) Tabellenspalte verfügbar. Discogs befüllt weiterhin nur TDRC — TDOR ist für manuelle Nachpflege gedacht.

Umbenennen

Der Umbennungs-Dialog zeigt eine Vorschau die sich bei jeder Masken-Änderung sofort aktualisiert.

Masken speichern

Eigene Masken mit 💾 speichern und mit 🗑 löschen. Die zuletzt verwendete Maske wird beim nächsten Öffnen vorausgewählt.

Relative vs. absolute Pfade

• Relative Maske %6-%2 — Dateien bleiben im selben Ordner.
• Absolute Maske I:\Musik\%1\[%4] %3\%6-%2 — Dateien werden in die angegebene Struktur verschoben. Unterordner werden angelegt. folder.jpg wird automatisch mitkopiert.

Datei → Tag

Die Umkehrung von Umbenennen: liest Künstler/Titel/Album/Jahr/Genre/Track-Nr. aus dem Datei- und Ordnernamen anhand derselben %1–%6-Maskensprache und schreibt sie in die Tags.

• Maske z.B. %1\[%4]-%3\%6-%1-%2 liest aus Front 242\[1988]-Front By Front\03-Front 242-Headhunter.mp3 Künstler, Jahr, Album, Track-Nr. und Titel.
• Stehen mehrere Platzhalter im selben Namens-Segment (z.B. %6-%1-%2), matchen alle bis auf den letzten non-greedy bis zum nächsten Trennzeichen — der letzte nimmt den Rest. So funktionieren auch Titel, die selbst das Trennzeichen enthalten.
• Vorschau-Tabelle zeigt die erkannten Werte pro Datei, bevor geschrieben wird.
• Eigene Masken speichern/löschen wie beim Umbenennen-Dialog; ⚡-Button wendet die letzte Maske sofort an.

Rückgängig

Der ↩ Rückgängig-Button macht die letzte Umbenennen- oder Datei→Tag-Aktion (voller Dialog oder ⚡-Schnellversion) rückgängig — immer nur den letzten Schritt, kein mehrstufiger Verlauf.

• Bei Umbenennen: Dateien werden an ihren alten Pfad zurückverschoben, eine dabei neu angelegte/kopierte folder.jpg am Zielordner wird wieder entfernt.
• Bei Datei→Tag: die vor dem Schreiben gesicherten alten Tag-Werte werden zurückgeschrieben.
• Der Button ist nur aktiv, wenn es etwas rückgängig zu machen gibt.

BPM-Berechnung

Der Button ♩ BPM startet die Berechnung für alle markierten Dateien im Hintergrund. Die Statusleiste zeigt den Fortschritt. Dateien mit vorhandenem TBPM-Tag werden übersprungen.

Die Berechnung analysiert maximal 60 Sekunden pro Datei (ausreichend für genaue Ergebnisse). Der berechnete Wert wird in das TBPM-ID3-Tag geschrieben und in der BPM-Spalte der Tabelle angezeigt.

Cover-Qualitäts-Scanner

Der 🔍 Cover-Scan-Button scannt alle Unterordner des im Explorer markierten Ordners und listet Alben mit Cover-Problemen:

Doppelklick auf einen Eintrag lädt den Ordner direkt in den Tagger zur Korrektur.

Automatische Nummerierung

Der Button # Nummerierung schreibt fortlaufende Track-Nummern in die Tags aller markierten Dateien — in der Reihenfolge wie sie in der Tabelle erscheinen.

Auffüllung richtet sich nach der Gesamtzahl:

• 1–9 Tracks → einstellig: 1, 2, 3
• 10–99 Tracks → zweistellig: 01, 02, 03
• 100+ Tracks → dreistellig: 001, 002, 003

Adolar-Integration

Adolar ist eine separate Musik-Bibliotheks-Web-App. Statt Tags dort zu bearbeiten, kann Taggster sie weiterhin lokal bearbeiten und Adolar automatisch informieren, damit die Bibliothek aktuell bleibt.

Einrichtung

Adolar-Leiste

Sobald konfiguriert, erscheint eine 🚀 ADOLAR-Leiste oberhalb der Favoriten. Ein Klick baut die Verbindung erneut auf und öffnet den gemappten Bibliotheksordner im Explorer-Baum — ab dann werden Änderungen in diesem Bereich automatisch an Adolar gemeldet.

Automatischer Sync

• Jede Tag-/Cover-Änderung löst — gebündelt und mit kurzer Verzögerung (Debounce) — einen gezielten Rescan des betroffenen Ordners in Adolar aus (kein voller Bibliotheks-Scan).
• Jedes Umbenennen/Verschieben meldet alten und neuen Pfad, damit Adolar seine Datenbank statt eines kompletten Neuscans nur anpasst.
• Schlägt eine Meldung fehl (z.B. keine Verbindung), wird sie protokolliert und lässt sich später über den 🚀 Sync-Button oder beim nächsten Klick auf die Adolar-Leiste nachholen.
• Im Adolar-Verbindungsdialog zeigt Letzte Syncs die letzten 20 erfolgreichen Synchronisationen (Datei/Ordner + Datum).

Umbenennungsmasken – Variablen

Unterordner werden mit \ erzeugt. Absolute Pfade beginnen mit einem Laufwerksbuchstaben:

I:\Musik\%1\[%4] %3\%6 - %2

Tabellenspalten

Einstellungen

Erreichbar über Tools → Einstellungen.

Alle weiteren Einstellungen (Masken, Spalten-Layout, Favoriten, zuletzt geöffneter Ordner, Discogs-Checkbox-Zustände) werden automatisch in ~/.adolartaggster.json gespeichert. Die Adolar-Verbindung (URL, Token, Bibliothek, Sync-Log) liegt getrennt davon in ~/.adolartaggster-adolar.json.