Berechtigungen & Werkzeuge

Welche Berechtigungen ein Assistent bekommen kann, alle Werkzeuge von Sonodex nach Bereich mit der nötigen Berechtigung und Beispiele zum Ausprobieren.

ProZuletzt aktualisiert:

Auf dieser Seite

BerechtigungenLink zu „Berechtigungen“

BerechtigungAuf der AnmeldeseiteLokal (Schalter in Sonodex)Erlaubt
library:readLibrary lesenLokalen MCP-Server aktivierenAlle lesenden Werkzeuge. Immer Teil der Verbindung.
playlists:writePlaylists anlegen und bearbeitenPlaylists anlegen und bearbeiten erlaubenVorschläge für Playlists, Smartlists und Sets, Löschen, Export und Import
edit_tracksTracks bearbeiten – Änderungen nur nach deiner Bestätigung in SonodexAssistenten dürfen Änderungen vorschlagenVorschläge für Metadaten, Cover, Tags, Cues und Beatgrids, Dubletten, Dateien und bearbeitete Audio-Kopien
library:read + SchalterLibrary lesenAssistenten dürfen den Player steuernDen Vorhör-Player steuern; ohne den Schalter abgelehnt

Über das Konto braucht ein ändernder Werkzeugaufruf beides: die Berechtigung auf der Anmeldeseite und den Schalter in Sonodex. Ohne Pro bleiben die Werkzeuge sichtbar, jeder Aufruf liefert aber nur einen Hinweis auf den Plan. Alle ändernden Werkzeuge nehmen zusätzlich dryRun (nur Vorschau) und, wo sie ein Ziel haben, expectedVersion an; siehe Änderungen bestätigen.

Verbindung & VorschlägeLink zu „Verbindung & Vorschläge“

WerkzeugWas es tutBerechtigung
get_capabilitiesAls Erstes aufrufen: Sonodex-Version und Verbindung, erteilte Berechtigungen und Schalter, verfügbare Werkzeugfamilien mit Begründung, ob ein Werkzeug deine Bestätigung braucht, bearbeitbare Felder je Dateiformat, Exportformate und Grenzenlibrary:read
list_pending_changesEigene Vorschläge, die noch auf Bestätigung wartenlibrary:read
get_change_historyAbgeschlossene eigene Vorschläge mit Zeitpunkten und ob sie sich noch rückgängig machen lassenlibrary:read
cancel_pending_changeZieht einen eigenen offenen Vorschlag zurück; ändert nichtsplaylists:write oder edit_tracks
undo_operationSchlägt vor, einen übernommenen eigenen Vorschlag in einem Schritt zurückzunehmen, solange er die neueste Änderung istplaylists:write oder edit_tracks

Lesen & SuchenLink zu „Lesen & Suchen“

WerkzeugWas es tutBerechtigung
crateflow_get_statusPrüft, ob dein Sonodex Desktop online ist (nur über das Konto)library:read
searchSucht nach Artist, Titel, Album, Genre oder Taglibrary:read
fetchAlle Details eines gefundenen Trackslibrary:read
search_tracksFiltert nach Text, BPM-Bereich, Tonart (Camelot wie 8A oder musikalisch wie Am) und Genre, bis zu 100 Trefferlibrary:read
advanced_search_tracksKombinierte Filter: BPM (auch halbes/doppeltes Tempo), Tonarten oder harmonisch passend, Genres, Energy, Bewertung, Tags, Dauer, Formate, Datum, Plays, Playlist-Mitgliedschaft, fehlende Felder; sortiert und seitenweise (bis 200), mit version je Tracklibrary:read
library_overviewGröße der Bibliothek, BPM-Bereich, häufigste Genres und Tonartenlibrary:read
list_playlistsAlle Playlists, Smartlists und Sets mit Trackzahllibrary:read
get_playlistTracks einer Playlist in ihrer Reihenfolgelibrary:read
suggest_nextTracks, die gut nach einem Track passen (Tonart, Tempo, Energy, Genre)library:read

Metadaten & CoverLink zu „Metadaten & Cover“

WerkzeugWas es tutBerechtigung
get_track_metadataAlle Metadaten eines Tracks: Library-Felder, Tags der Datei, welche Felder das Format speichern kann, ob es ein Cover gibt (auf Wunsch kleine Vorschau)library:read
preview_track_editSchlägt Änderungen an einem Track vor, optional mit Cover; liefert die genaue Vorschauedit_tracks
update_track_metadataFragt den Stand eines Vorschlags ab und zeigt den Dialog erneut; übernimmt selbst nichtsedit_tracks
upload_cover_artLädt ein Coverbild hoch (JPEG oder PNG, bis 8 MB und 16 Megapixel; über ChatGPT bzw. das Konto etwa 700 KB); ändert noch keinen Trackedit_tracks
set_track_coverSchlägt ein hochgeladenes Cover für bis zu 500 Tracks voredit_tracks
remove_track_coverSchlägt vor, das Cover von bis zu 500 Tracks zu entfernenedit_tracks
batch_edit_tracksSchlägt Metadaten-Änderungen für bis zu 500 Tracks als einen Vorschlag voredit_tracks
revert_track_editSchlägt vor, einen übernommenen Vorschlag zurückzunehmen; inzwischen erneut geänderte Werte bleibenedit_tracks
get_change_statusStatus eines Vorschlags: awaiting_confirmation, applied, cancelled, expired, stale oder failedlibrary:read

Set-Builder & ÜbergängeLink zu „Set-Builder & Übergänge“

WerkzeugWas es tutBerechtigung
build_setBaut ein Set für eine Ziellänge (5 bis 720 Minuten): Tempoverlauf von Start- zu End-BPM, Energiekurve, standardmäßig harmonisch (Camelot), optional Genres, Quell-Playlist, Ausschlüsse und Pflicht-Tracks; mit Rollen, Startzeiten und Hinweisen je Übergang. Speichert nichts.library:read
analyze_transitionBewertet einen Übergang von 0 bis 100 nach BPM (auch halb/doppelt), Tonart, Energie und Genre, mit Mix-Tipplibrary:read
analyze_set_transitionsBewertet jeden Übergang einer Playlist oder Trackliste, nennt die schwächsten und Ersatz- oder Brücken-Trackslibrary:read
optimize_track_orderSchlägt eine Reihenfolge mit besseren Übergängen vor, mit Wert vorher und nachher; Opener und Closer lassen sich festhalten. Speichert nichts.library:read
analyze_dj_setAnalysiert ein Set (Playlist oder bis zu 500 Tracks) wie gespielt: echte Länge mit Überblendungen (Standard 16 Takte), Startzeit je Track, Verlauf von BPM, Tonart und Energy, schwierige Übergänge, Wiederholungen, fehlende Metadaten und Empfehlungenlibrary:read
save_set_as_playlistSchlägt vor, ein Set (2 bis 500 Tracks) in Sonodex zu speichern, mit Gesamtdauer und Übergangswertenplaylists:write

PlaylistsLink zu „Playlists“

WerkzeugWas es tutBerechtigung
create_playlistSchlägt eine neue Playlist aus Track-IDs vorplaylists:write
add_tracks_to_playlistSchlägt vor, Tracks an einer Position einzufügen (Standard: am Ende); vorhandene werden übersprungenplaylists:write
remove_tracks_from_playlistSchlägt vor, Tracks aus einer Playlist zu entfernen; sie bleiben in der Bibliothekplaylists:write
reorder_playlistSchlägt eine neue, vollständige Reihenfolge vorplaylists:write
rename_playlistSchlägt einen neuen Namen für Playlist, Smartlist oder Set vorplaylists:write
duplicate_playlistSchlägt eine Kopie im selben Ordner vor (Standardname „<Name> (Kopie)“)playlists:write
optimize_playlistSchlägt die Reihenfolge mit den besten Übergängen für eine Playlist mit 3 bis 250 Tracks vorplaylists:write
delete_playlistSchlägt vor, eine Playlist, Smartlist oder ein Set zu löschen; im Dialog ist zusätzlich das Häkchen „Playlist löschen bestätigen“ nötig. Tracks bleiben in der Bibliothek; ein Rückgängig-Schrittplaylists:write

Smart PlaylistsLink zu „Smart Playlists“

WerkzeugWas es tutBerechtigung
get_smart_playlist_rulesRegeln einer Smartlist in Worten und im Regelformat, mit Trefferzahl und den ersten 20 Trackslibrary:read
create_smart_playlistSchlägt eine neue Smartlist aus Regeln vor; die Vorschau zeigt, wie viele Tracks passenplaylists:write
update_smart_playlistSchlägt neue Regeln und/oder einen neuen Namen vor; die neuen Regeln ersetzen alle bisherigenplaylists:write

Das Regelformat: match „all“ (Standard, alle Kriterien) oder „any“ (eines genügt), dazu bpm, energy (1–10) und year als Bereich mit min/max, genres (genaue Namen), keys (Camelot, Open Key oder musikalisch), compatibleWith (eine Tonart und ihre harmonischen Camelot-Nachbarn), tags mit any, all oder none und ratingMin (1–5). Bei „all“ höchstens fünf Werte pro Liste.

Beispiel für Smartlist-Regeln
{"bpm": {"min": 124, "max": 128}, "genres": ["House", "Tech House"], "energy": {"min": 6}, "tags": {"none": ["Warmup"]}}

Bibliothek prüfenLink zu „Bibliothek prüfen“

WerkzeugWas es tutBerechtigung
audit_libraryGesundheitscheck mit Zahlen und ersten Funden je Kategorie: Dubletten, fehlende Metadaten und Cover, verdächtige BPM, uneinheitliche Genres, fehlende Dateien, Formate, die DJ-Geräte evtl. nicht laden, fehlende Tonart, kaputter Text; je mit Korrekturvorschlaglibrary:read
find_duplicate_tracksDubletten-Gruppen nach Audio, Fingerprint oder Artist/Titel/Version bei gleicher Länge, mit Empfehlung, welche Kopie bleibtlibrary:read
find_missing_metadataTracks mit leeren Feldern und Zählung je Feldlibrary:read
validate_track_filesPrüft Dateien jetzt: vorhanden, lesbar, nicht leer, Größe geändert, Inhalt passt zur Endung; ändert nichtslibrary:read

Statistiken & VerlaufLink zu „Statistiken & Verlauf“

WerkzeugWas es tutBerechtigung
get_track_statsAlles Gespeicherte zur Nutzung eines Tracks: Play-Zähler, Auftritte in gespeicherten Sets, Playlists, häufige Nachbarnlibrary:read
get_play_historyGespeicherte Plays aus Set-Snapshots und importierten Rekordbox-Historien, neueste zuerstlibrary:read
analyze_library_usageMeist- und wenig gespielte Tracks, ungenutzte Tracks, häufige Paare und Verteilungen nach Genre, BPM, Tonart und Energylibrary:read
get_set_historyGespeicherte Sets und Gigs mit Datum, Ort, Bewertung, Notizen und Tracklistelibrary:read

TagsLink zu „Tags“

WerkzeugWas es tutBerechtigung
suggest_track_tagsSchlägt Tags aus dem DJ-Vokabular vor, je mit Sicherheit und Grund; vorhandene Tags nicht noch einmallibrary:read
analyze_track_moodStimmungsskizze eines Tracks aus Metadaten: Energie, Dur/Moll, Intensität, Vocals, Energieverlauf, Drops; kein Hörtestlibrary:read
list_untagged_tracksTracks ohne Tags oder ohne Tag aus dem DJ-Vokabularlibrary:read
batch_tag_tracksSchlägt vor, Tags bei bis zu 500 Tracks hinzuzufügen oder zu entfernen; andere Tags bleibenedit_tracks

Das DJ-Vokabular hat 12 Tags: Warmup, Buildup, Peak Time, Closing, Euphoric, Dark, Bouncy, Vocal, Driving, Melodic, Aggressive, High Energy. Hinzufügen lassen sich diese oder Tags, die deine Bibliothek schon verwendet.

DJ-VorbereitungLink zu „DJ-Vorbereitung“

WerkzeugWas es tutBerechtigung
analyze_track_audioGespeicherte Analyse mit Herkunft und Sicherheit: BPM, Tonart, Energy, Qualitätswerte, Beats, Abschnitte, Energieverlauf, Waveform; Lautheit (LUFS, Loudness Range, True Peak) wird bei Bedarf im Hintergrund gemessenlibrary:read
get_analysis_jobStand einer Hintergrundmessung (Lautheit, Beatgrid-Prüfung); wartet auf Wunsch bis 20 Sekundenlibrary:read
get_track_cue_pointsAlle Cues eines Tracks: Hot Cues A–P, Memory-Cues und Loops mit Position, Takt, Bezeichnung, Farbe und Herkunftlibrary:read
generate_cue_point_suggestionsCue-Vorschläge für bis zu 20 Tracks mit Begründung, auf Abschnittsanfänge und Takte des Beatgrids oder per Cue-Vorlage und Cue-Profillibrary:read
get_track_beatgridDas gespeicherte Beatgrid: Tempo, erster Beat und Downbeat, Tempo-Abschnitte, geschützt oder nicht, Herkunftlibrary:read
analyze_beatgridMisst, wie gut das Grid passt: Versatz, Drift, halbes oder doppeltes Tempo, Hinweise auf Takt 1library:read
analyze_transition_detailPlant einen Übergang: Mix-out- und Mix-in-Bereiche mit Phrasen, Überlappung, Tempoanpassung und Übergangsart mit Gründenlibrary:read
prepare_track_for_djingVorbereitungsbericht als Checkliste für einen Track; liest nurlibrary:read
propose_track_preparationSchlägt die Cues und die gemessene Grid-Korrektur aus dem Bericht als einen gemeinsamen Vorschlag voredit_tracks
add_cue_pointSchlägt einen neuen Hot Cue, Memory-Cue oder Loop vor, an einer Zeit oder einem Taktedit_tracks
update_cue_pointSchlägt vor, einen Cue zu verschieben oder zu ändernedit_tracks
delete_cue_pointSchlägt vor, einen Cue zu löschenedit_tracks
apply_cue_suggestionsMacht aus Cue-Vorschlägen (ganz oder teilweise) einen Vorschlag; vorhandene Cues bleibenedit_tracks
update_track_beatgridSchlägt eine Beatgrid-Änderung vor (Tempo, erster Beat, Downbeat, Zählzeit, Tempo-Abschnitte); geschützte Grids werden abgelehntedit_tracks

Den Ablauf beschreibt Tracks vorbereiten mit ChatGPT.

Bibliothekspflege & DateienLink zu „Bibliothekspflege & Dateien“

WerkzeugWas es tutBerechtigung
compare_duplicate_tracksVergleicht 2 bis 10 Tracks nebeneinander mit Urteil je Paar und Empfehlung, welche Kopie bleibt; andere Versionen gelten nie als Dublettenlibrary:read
check_missing_filesPrüft, welche Audiodateien fehlen oder nicht lesbar sind, bis 500 Tracks pro Aufruflibrary:read
locate_track_fileWo die Datei eines Tracks liegt (relativ zur Bibliothek), ob es sie gibt, Größe und Formatlibrary:read
resolve_duplicate_tracksSchlägt vor, Dubletten zusammenzuführen: Playlists zeigen auf den behaltenen Track, die Kopien werden archiviert, nie gelöschtedit_tracks
relink_missing_trackSucht eine fehlende Datei in Bibliotheks- und überwachten Ordnern und schlägt vor, sie neu zu verknüpfenedit_tracks
rename_track_fileSchlägt vor, Audiodateien nach einer Vorlage umzubenennenedit_tracks
move_track_fileSchlägt vor, Audiodateien in einen Ordner innerhalb des Bibliotheksordners zu verschiebenedit_tracks
export_playlistSchlägt den Export von Playlists als M3U8, CSV, JSON oder HTML in den gemerkten Export-Ordner vorplaylists:write
export_track_metadataSchlägt den Export der Metadaten von Tracks oder einer Playlist als CSV oder JSON vorplaylists:write
import_playlistSchlägt eine neue Playlist aus M3U/M3U8, CSV oder Text vor, über den Track Matcher zugeordnetplaylists:write

Den Ablauf beschreibt Bibliothek pflegen mit ChatGPT.

PlayerLink zu „Player“

WerkzeugWas es tutBerechtigung
get_playback_statusStand des Vorhör-Players und ob Assistenten ihn gerade steuern dürfen; geht ohne Schalterlibrary:read
load_trackLädt einen Track pausiert in den Playerlibrary:read + Schalter
play_trackStartet die Wiedergabe, auf Wunsch mit einem anderen Tracklibrary:read + Schalter
pause_trackPausiert die Wiedergabelibrary:read + Schalter
seek_trackSpringt an eine Stelle des geladenen Trackslibrary:read + Schalter
set_preview_volumeLautstärke des Players (0 bis 1)library:read + Schalter
audition_transitionSpielt das Ende eines Tracks und danach den Anfang des nächsten an, ohne Überblendunglibrary:read + Schalter

„Schalter“ heißt: „Assistenten dürfen den Player steuern“ (standardmäßig aus). Gesperrt während Auflegen läuft oder ein Dialog offen ist; höchstens 30 Steuerbefehle pro Minute.

Audio-Bearbeitung & StemsLink zu „Audio-Bearbeitung & Stems“

WerkzeugWas es tutBerechtigung
trim_audioRendert eine gekürzte Kopie mit optionalen Blenden, auf Beats geschnittenedit_tracks
adjust_audio_tempoRendert eine Kopie im neuen Tempo (Faktor 0,8 bis 1,25), die Tonhöhe bleibtedit_tracks
transpose_audioRendert eine Kopie um −6 bis +6 Halbtöne versetzt, das Tempo bleibtedit_tracks
normalize_audioRendert eine auf −14 bis −6 LUFS normalisierte Kopieedit_tracks
render_audio_editRendert mehrere dieser Schritte in einer Kopieedit_tracks
get_render_jobStand eines Renders; fertig mit der ID des Vorschlagslibrary:read
cancel_render_jobBricht einen eigenen laufenden Render ab, ohne Rückfrage; die halbe Datei wird gelöschtedit_tracks
get_available_stemsListet Stem-Dateien, die schon auf der Platte liegen (nur Dateinamen)library:read
separate_audio_stemsNicht verfügbar: antwortet immer mit unsupported_operation (Grund stem_engine_missing)edit_tracks
export_audio_stemsNicht verfügbar: antwortet immer mit unsupported_operation (Grund stem_engine_missing)edit_tracks

Jeder Render endet in einem Vorschlag mit Vorhören; bestätigt wird eine neue Datei als neuer Track, das Original bleibt unverändert. Mehr unter Player & Audio-Bearbeitung.

Cue-Workflows (nur lokal)Link zu „Cue-Workflows (nur lokal)“

workflow_start, workflow_status, workflow_propose und workflow_preview planen Cues für bis zu 200 Tracks mit einem Template und ändern nichts; workflow_apply und workflow_undo übernehmen bzw. nehmen einen geprüften Cue-Vorschlag zurück, nur mit „Cue-Vorschläge übernehmen erlauben“. Siehe Lokaler MCP-Server.

BeispieleLink zu „Beispiele“

Lesen & Suchen
„Welche Tracks zwischen 124 und 128 BPM in 8A habe ich?“
Set-Builder
„Baue mir ein 60-Minuten-Hard-Trance-Set von 145 auf 160 BPM, harmonisch, und speichere es als Playlist.“ Der Assistent baut das Set, prüft die Übergänge, zeigt es dir und schlägt nach deinem Okay das Speichern vor; du bestätigst in Sonodex.
Übergänge
„Prüf die Übergänge meiner Playlist ‚Samstag‘ und schlag eine bessere Reihenfolge vor.“
Playlists
„Füg diese fünf Tracks an Position 3 der Playlist ‚Warm-up‘ ein.“
Smart Playlists
„Leg eine Smartlist an: 124 bis 128 BPM, House oder Tech House, Energy ab 6, ohne Tag Warmup.“
Metadaten & Cover
„Setz bei allen Tracks der Playlist ‚Promo Oktober‘ das Label auf ‚Night Drive Records‘.“ oder „Nimm dieses Bild als Cover für die drei Versionen von ‚Glue‘.“
Bibliothek prüfen
„Prüf meine Bibliothek auf Dubletten, fehlende Cover und verdächtige BPM.“
Statistiken
„Welche Tracks habe ich in den letzten drei Monaten am häufigsten gespielt?“
Tags
„Schlag Tags für meine ungetaggten Tracks vor und vergib sie, wenn ich zustimme.“
DJ-Vorbereitung
„Prüf das Beatgrid von ‚Coastline‘ und setz Hot Cues auf Intro, Drop und Outro.“ oder „Wie mische ich von ‚Warehouse Jack‘ in ‚Coastline‘?“
Set-Analyse
„Wie lang läuft meine Playlist ‚Samstag‘ wirklich, und wo sind die schwierigsten Übergänge?“
Bibliothekspflege
„Führ die Dubletten von ‚Glue‘ zusammen.“ oder „Welche Dateien fehlen, und findest du sie wieder?“
Export & Import
„Exportier die Playlist ‚Samstag‘ als M3U8.“ oder „Leg aus dieser Trackliste eine Playlist an.“
Player
„Spiel mir den Übergang von ‚Velvet Room‘ in ‚Coastline‘ vor.“
Audio-Bearbeitung
„Mach eine Intro-Edit von ‚Glasshouse‘ und normalisiere sie auf −9 LUFS.“
Vorschläge
„Welche Änderungen warten noch auf mich? Zieh den letzten Vorschlag zurück.“

Etwas fehlt oder stimmt nicht? Sag uns Bescheid. Die Oberfläche gibt es auch auf Englisch; die Docs nennen die deutschen Bezeichnungen.

Originale Sonodex-App · Demo-Bibliothek