UNIVERSAL TRACK LINK FINDER (BY TONETRAX) – VERSION 2.4.2
========================================================

Portable Windows-Anwendung zum Ermitteln plattformübergreifender Musiklinks über die MusicLink API.

UNTERSTÜTZTE SUCHEINGABEN

- Spotify-Track-Link
- Spotify-Track-ID (22 Zeichen)
- Spotify-Track-URI (spotify:track:…)
- Apple-Music-Track-Link
- ISRC mit oder ohne Bindestriche, zum Beispiel DE-YW8-26-11866 oder DEYW82611866

Andere Quellen wie Deezer oder Tidal sowie Spotify- und Apple-Music-Albumlinks werden bewusst abgelehnt. Die Prüfung erfolgt vor dem API-Aufruf und verbraucht bei ungültigen Eingaben keine MusicLink-Anfrage.

VERWENDUNG

1. Tonetrax_Universal_Track_Link_Finder.exe starten.
2. Unter EINSTELLUNGEN den persönlichen MusicLink API-Key eintragen.
3. Spotify-Link/-ID, Apple-Music-Link oder ISRC eingeben.
4. LINKS FINDEN anklicken oder die Eingabetaste drücken.

Angezeigt werden Titel, Artist, ISRC, Cover und alle gültigen Plattformlinks, die MusicLink tatsächlich liefert. Nicht gelieferte Links werden weder ergänzt noch geraten.

KOPIEREN übernimmt einen Link in die Zwischenablage. LINK ÖFFNEN startet ihn im Standardbrowser.

LINKS PRÜFEN testet die Erreichbarkeit aller angezeigten Plattformlinks. Die Ergebnisse unterscheiden erreichbare Seiten, Weiterleitungen, eindeutig fehlende Seiten und unklare Antworten. Musikplattformen können automatische Anfragen blockieren; die richtige Trackzuordnung kann damit nicht bestätigt werden. Die Prüfung verändert keine Links und verbraucht keine MusicLink-Anfragen.

MEHRFACHSUCHE UND SAMMELEXPORT

In MEHRFACHSUCHE eine Eingabe pro Zeile einfügen: Spotify-Track-Link/-ID, Apple-Music-Track-Link oder ISRC. Duplikate werden erkannt. Vor dem Start wird die maximale Zahl nötiger MusicLink-Anfragen angezeigt. Cacheeinträge werden ohne neue API-Anfrage genutzt. Andere Einträge werden nacheinander abgefragt. Bei Rate-Limit oder ungültigem API-Key stoppt die Suche. Bereits gefundene Ergebnisse bleiben exportierbar.

SAMMELEXPORT speichert erfolgreiche Ergebnisse gemeinsam als JSON, TXT oder CSV. JSON nutzt das bekannte Track-Paket-Format mit mehreren Einträgen in tracks; CSV enthält eine Spalte pro Plattform. Fehlerhafte und fehlgeschlagene Eingaben werden nicht exportiert.

CACHE UND VERLAUF

Erfolgreiche Ergebnisse werden lokal in cache.json neben der EXE gespeichert. VERLAUF LADEN erlaubt das Suchen, Laden, Löschen und vollständige Aktualisieren gespeicherter Tracks. Eine API-Aktualisierung verbraucht eine neue Anfrage.

Im Verlauf können einzelne Einträge angehakt oder mit ALLE ANHAKEN alle Tracks gewählt werden. ANGEHAKTE AKTUALISIEREN fragt sie nacheinander erneut ab. Häkchen bleiben beim Filtern erhalten. Vor dem Start wird die maximale Zahl der API-Anfragen bestätigt. Zwischen Anfragen liegt eine kurze Pause. Bei einem kurzfristigen Rate-Limit mit höchstens zehn Sekunden Retry-After wird nach der angegebenen Wartezeit einmal erneut versucht; längere Limits und ein ungültiger API-Key stoppen die Abfrage. Fehlgeschlagene oder nicht eindeutig zuzuordnende Tracks bleiben unverändert. Die übrigen Ergebnisse und Änderungen können geprüft, einzeln abgewählt und dann gemeinsam übernommen werden. SCHLIESSEN verwirft alle noch nicht übernommenen Ergebnisse.

Vor dem Ersetzen vorhandener Cache-Daten zeigt der Änderungsvergleich neue, geänderte und weggefallene Links. AKTUALISIERUNG ÜBERNEHMEN speichert die neuen Daten; ALTE DATEN BEHALTEN verwirft sie. Metadaten und Cover können sich auch ohne Linkänderung unterscheiden.

EXPORT

TRACK-PAKET SPEICHERN exportiert JSON oder TXT mit Titel, Artist, ISRC, optionaler Spotify-Track-ID, Cover-URL und allen gelieferten Plattformlinks. Das Cover kann separat gespeichert werden. Dabei kann eine der tatsächlich verfügbaren Originalgrößen ausgewählt werden. Freie Zwischenwerte und künstliche Hochskalierung gibt es nicht.

SPRACHE UND FARBEN

DE und ENG schalten die Sprache sofort um; die Auswahl wird in config.ini gespeichert. Farben sind frei konfigurierbar. Unzureichender Kontrast wird korrigiert. Eigene Theme-Presets lassen sich speichern, aktualisieren, umbenennen, löschen, importieren und exportieren.

INFO UND STARTHINWEIS

Der Info-Tab nennt die derzeit 20 bekannten MusicLink-Ziele und erklärt die abhängige Verfügbarkeit. Beim ersten Start erscheint diese Information zusätzlich als Dialog. Sie kann dauerhaft abgeschaltet und im Info-Tab jederzeit wieder aktiviert werden.

PORTABLE DATEIEN

- config.ini: API-Key, Sprache, Startverhalten und Einstellungen
- cache.json: lokaler Track-Verlauf
- theme-presets.json: eigene Theme-Presets

Der Programmordner muss beschreibbar sein.

Beim Wechsel von v2.4.1 die neue EXE in den bisherigen Programmordner kopieren, damit config.ini, cache.json und theme-presets.json erhalten bleiben. Alternativ diese drei Dateien in den neuen Portable-Ordner übernehmen.

DATENSCHUTZ UND NETZWERK

Die Anwendung enthält keine Analytics und keine Telemetrie. Suchanfragen gehen per HTTPS an MusicLink. Die Linkprüfung sendet direkte HTTP(S)-Anfragen an die Plattformlinks. Cover von MusicLink, Spotify-oEmbed und – sofern ein Apple-Music-Link vorhanden ist – Apple Music werden anhand ihrer tatsächlichen Pixelgröße geprüft. Automatisch wird die größte verfügbare Variante angezeigt. Ein MusicLink API-Key ist erforderlich. Powered by MusicLink ist sichtbar im Kopf enthalten.

HINWEISE UND HAFTUNG

NUR FÜR DEN PRIVATGEBRAUCH. KEINE GARANTIE UND KEINE HAFTUNG.

Gefundene Links sollten vor der Veröffentlichung auf Plausibilität geprüft werden. Verfügbarkeit und Zuordnung können je nach Region und Plattform abweichen.

CHANGELOG VERSION 2.4.2

- Spotify-IDs aus dem Verlauf nutzen den passenden MusicLink-Endpunkt
- Kurze Pause zwischen API-Abfragen der Sammelaktualisierung
- Ein begrenzter Wiederholungsversuch bei kurzem Retry-After
- HTTP-Code und Fehlertext im Prüffenster deutlicher angezeigt
