Maintaining your library with ChatGPT

Duplicates#Link to “Duplicates”

compare_duplicate_tracks compares 2 to 10 tracks side by side: metadata, version (Extended Mix, Radio Edit, Remix …), format, bitrate, duration, cues, playlists, whether the audio is identical and how similar the fingerprint is. For each pair there is a verdict and a recommendation on which copy to keep. Different versions of a song never count as duplicates.

resolve_duplicate_tracks proposes merging: in playlists and sets the kept track takes the place of the copies; if you wish, it takes over cues (only with provably identical audio and if it has none itself) and fills empty fields. The copies are then archived.

Missing files#Link to “Missing files”

• check_missing_files checks which audio files are missing or unreadable (up to 500 tracks per call, streaming and archive excluded).
• locate_track_file tells you where a track’s file is, whether it exists, how big it is and what format it has.
• relink_missing_track searches for the file in your library folder and the watched folders (same name, same size, audio fingerprint). With a unique match a suggestion is created; otherwise the assistant names the candidates and you choose.

Rename and move#Link to “Rename and move”

• rename_track_file renames audio files using a template made of {artist}, {title}, {genre}, {album}, {year} and {label} (default “{artist} - {title}”; the extension stays). Only files in the library folder or a watched folder.
• move_track_file moves audio files to a folder inside your library folder, for example “House/2026”. For this, a library folder must be set under Settings → Incoming.

Existing files are never replaced; the dialogue reports conflicts per track. Sonodex does not create a backup copy. Since 2.2.1, Undo does not move or rename the file back; the library keeps the new path.

Locations instead of paths#Link to “Locations instead of paths”

Assistants only see files by name and folder relative to your library folder or a watched folder, for example “Music/House”. If a file is elsewhere, it is called “outside the library”. Sonodex never gives out full paths.

Export#Link to “Export”

• export_playlist exports up to 20 playlists, one file each, as M3U8, CSV, JSON or HTML.
• export_track_metadata exports the metadata of up to 5000 tracks or one playlist as CSV or JSON to a file.

The file only goes into the folder you last chose in Quick export for this format. JSON has no format of its own there and uses the folder for CSV. Without a remembered folder, Sonodex declines; in that case, export once yourself and choose the folder. Existing files are never overwritten, and the dialogue shows the file name.

Import#Link to “Import”

import_playlist creates a playlist from M3U, M3U8, CSV or text (one line “Artist - Title” per track, at most 1 MB). The Track Matcher matches the entries to your tracks: same file, file name, artist, title, version, duration, ISRC. The dialogue shows matched, uncertain and not found entries; the playlist only gets the matched tracks. Nothing is downloaded.

Shares#Link to “Shares”

Examples#Link to “Examples”

• “I have ‘Glue’ three times. Which copy should I keep? Merge them.”
• “Which files are missing from my library, and can you find them again?”
• “Rename all files in the playlist ‘Promo October’ to ‘Artist - Title’.”
• “Export the playlist ‘Saturday’ as M3U8 and the metadata as CSV.”
• “Here is my track list from the weekend. Create a playlist from it.”