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

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

Im Track-Suchfeld werden andere Quellen wie Deezer oder Tidal sowie Albumlinks weiterhin abgelehnt. Die Prüfung erfolgt vor dem API-Aufruf und verbraucht bei ungültigen Eingaben keine MusicLink-Anfrage.

ALBUM-SUCHE

Im Kopf zwischen TRACK und ALBUM umschalten. Der markierte Schalter, die Modusbeschriftung und der dunklere Albumbereich zeigen den aktiven Modus. Eingabe und Ergebnis bleiben je Modus beim Umschalten erhalten. Erlaubt sind Spotify-Albumlinks/-IDs und spotify:album:-URIs, Apple-Music-Albumlinks ohne Track-Parameter i= sowie UPCs mit 12 bis 14 Ziffern. Track-Links werden dort abgelehnt. MusicLink v2 liefert Albumtitel, Artist, gegebenenfalls UPC, Cover-Link und Plattformlinks.

Der Album-Verlauf liegt getrennt in album-cache.json. VERLAUF LADEN bietet eine durchsuchbare Liste, Löschen, Einzelaktualisierung und Aktualisierung angehakter Alben mit Änderungsprüfung. LINKS PRÜFEN und COVER SPEICHERN sind auch für Alben verfügbar; beim Cover werden nur gefundene Originalgrößen angeboten. ALBUM-PAKET SPEICHERN bietet JSON und TXT. JSON verwendet das separate tonetrax-album-package mit albums, Titel, Artist, optionaler UPC/Spotify-Album-ID, Cover-URL und allen Links. Ein WordPress-Generator muss dieses separate Albumformat ausdrücklich unterstützen.

Die Einstellung für den Start mit letztem Sucheintrag stellt auch das zuletzt verwendete Album samt Album-Modus wieder her.

VERWENDUNG

1. Tonetrax_Universal_Track_Link_Finder.exe starten.
2. Unter EINSTELLUNGEN den persönlichen MusicLink API-Key eintragen.
3. TRACK oder ALBUM im Kopf wählen und eine passende Eingabe einsetzen.
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 beiden Modi verfügbar: Im Album-Modus Spotify-/Apple-Music-Albumlinks, Spotify-Album-IDs oder UPCs zeilenweise eingeben. Erfolgreiche Alben lassen sich gesammelt als JSON, TXT oder CSV speichern. Album-JSON enthält mehrere Einträge in albums und bleibt vom Track-Paket getrennt.

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 Zahl nötiger neuer MusicLink-Abfragen angezeigt. Cacheeinträge werden ohne neue API-Anfrage genutzt. Andere Einträge werden nacheinander mit dem eingestellten Abfrage-Tempo abgefragt. Bei einem kurzfristigen Rate-Limit gibt es nach Retry-After bis höchstens 90 Sekunden einen Wiederholungsversuch. Längere Limits oder ein ungültiger API-Key stoppen 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 auf mögliche zusätzliche Anfragen durch Wiederholungen hingewiesen. Das eingestellte Abfrage-Tempo gilt auch hier. Bei einem kurzfristigen Rate-Limit mit höchstens 90 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. Fehlt die ISRC, ist der Export möglich, aber der bisherige WordPress-Generator kann die JSON nicht importieren; das Programm weist darauf hin. 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.

MUSICLINK-VERBINDUNG UND ABFRAGE-TEMPO

Track- und Album-Suche nutzen api.musiclink.one/v2. Die Track-Antwort wird intern auf das bisherige Ergebnis abgebildet; Track-Cache und Track-Paket-JSON bleiben im bisherigen Format. Bei mehreren Treffern zur selben ISRC wird nicht automatisch einer gewählt: Bitte einen eindeutigen Spotify- oder Apple-Music-Track-Link verwenden. Website-, Dashboard- und Attribution-Links zeigen auf musiclink.one. Unter EINSTELLUNGEN > MusicLink API-Key kann der eigene Tarif für das Tempo der Sammelaktionen manuell gewählt werden: Free, Hobby, Developer oder Pro. Standard ist das vorsichtige Free-Tempo (mindestens 6,5 Sekunden zwischen Anfrage-Starts). Die Auswahl ändert weder den tatsächlichen Tarif noch den API-Key oder das monatliche Kontingent. Aktuelle Limits: https://musiclink.one/pricing

Ältere MusicLink-Weblinks aus dem lokalen Cache werden beim Laden im Speicher auf die neue Domain umgestellt; andere Plattformlinks bleiben unverändert.

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
- album-cache.json: separater Album-Verlauf (nach erster Album-Suche)
- theme-presets.json: eigene Theme-Presets

Der Programmordner muss beschreibbar sein.

Beim Wechsel von einer früheren Version die neue EXE in den bisherigen Programmordner kopieren, damit config.ini, cache.json, album-cache.json und theme-presets.json erhalten bleiben. Alternativ diese 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 3.0.0

- TRACK/ALBUM-Umschalter im Hauptfenster und deutliche Moduskennzeichnung
- Durchsuchbarer Album-Verlauf mit Einzel- und Sammelaktualisierung sowie Änderungsprüfung
- Album-Mehrfachsuche und Sammelexport als JSON, TXT oder CSV
- Album-Linkprüfung und Covergrößenwahl; Track-Dateien und Exporte unverändert
- Letzter Sucheintrag kann beim Start auch ein Album sein

CHANGELOG VERSION 2.7.0

- Track-Suche, Mehrfachsuche und Verlaufsaktualisierung auf MusicLink v2 umgestellt
- Bisheriges Track-Cache- und Track-Paket-Format erhalten; mehrdeutige ISRC-Treffer werden nicht automatisch übernommen
- Album-Pakete lassen sich jetzt als JSON oder TXT speichern

CHANGELOG VERSION 2.6.1

- „Kopieren“ und „Link öffnen“ stehen in der Track-Anzeige wie bei Alben nebeneinander
- Linkfeld und Buttons passen sich der Fensterbreite an

CHANGELOG VERSION 2.6.0

- Album-Suche über MusicLink v2 mit Spotify-/Apple-Music-Albumlinks oder UPC
- Separater Album-Verlauf und eigenes Album-JSON-Format
- Track-Suche, Track-Cache und Track-Paket bleiben unverändert

CHANGELOG VERSION 2.4.3

- MusicLink-API, Dashboard, Attribution und ältere MusicLink-Cachelinks auf musiclink.one umgestellt; API v1 bleibt erhalten
- Tarifabhängiges Tempo für Mehrfachsuche und Verlaufsaktualisierung, Free als Voreinstellung
- Ein Wiederholungsversuch nach Retry-After bis höchstens 90 Sekunden
- Bestehender Cache, Track-Export und Bedienkonzept bleiben erhalten
