Cleanup and duplicates

Cleanup and duplicates

Documentation home

Batch metadata cleanup

Open Overview → Metadata health → Clean up metadata…, or use the shortcut in the Combined genres album filter. Prepare a library-wide preview for combined genres, album artists, track artists or composers. The separate Review genre labels category lets you choose one exact stored label and enter its replacements, one per line, without guessing slash or comma separators. Remove this label from matching tracks explicitly removes only that label, preserving other genres or clearing the genre when it was the only one. Exclude albums, then approve and start. Changes are saved to iBroadcast in checked batches, with progress, stop/resume and a downloadable before/after report. Additional track artists are included in browsing, search and player links. Album cards use a compact queue + in their aligned information row.

Semicolon cleanup splits only ;; slashes, commas and ampersands are kept. Each batch contains at most 200 tracks from 20 displayed albums and is read back before the next batch. Conflicts, request errors or unconfirmed writes stop the job. Resume is explicit and rechecks current values. Preparing a preview does not save anything. See the cleanup instructions for the complete steps, exact genre replacement and recovery.

Move tracks to trash

In Albums, use any filter, such as 1–2 tracks, then tick albums in the grid or list and choose Move selected albums to trash…. Albums by different artists can be selected together; the same action is available on an album artist's page. Selections survive paging and filter changes. The selection count flags albums outside the current results, and Clear clears the whole selection. The review lists every album and lets you expand its tracks. Confirm once; larger selections use batches of up to 20 displayed albums / 500 tracks, checking complete membership and reading back each batch before continuing. Stop or close the review to prevent later batches. Changed albums or unconfirmed results stop processing. Results go to Change history; restarting never resumes the operation automatically. A single album/set above 500 tracks requires smaller track selections from its album page.

To find candidate albums, open Albums and choose the Duplicate tracks filter. Open an album to inspect its tracks.

For many albums, choose Review suggested copies across all albums… on that page. Analyse all albums prepares a local draft using the same format/date rules as Select suggested copies, across the entire library regardless of search or pagination. Opening the dialog only reads its saved report.

Expand an album to compare each proposed copy with the retained copies. Uncheck an album or an individual proposed track to keep it. Uncertain copies stay out of the selection; differing titles have an explicit comparison notice. After reviewing, tick the approval checkbox and choose Move selected copies to trash. Tagcast processes up to 200 tracks from 20 displayed albums per batch, checks current metadata and retained copies before writing, and reads the results back. Stop after current request prevents later batches. Drafts and results survive restarts on this computer and belong to the connected account. Check outstanding and continue checks interrupted requests first; an uncertain request is never automatically resent. Export the full report to keep a copy, and use Refresh album list afterwards to update the displayed counts. A new analysis replaces the old report. Batch results use this report separately from metadata Change history.

Remove unwanted duplicate copies from an album in three reviewed steps:

Use Albums → Duplicate tracks to find albums with repeated track numbers on one disc, for example 1, 1, 2, 3, 4, 4. The filter includes different titles, such as a plain title and a copy with added soundtrack information.

1. Open the album and choose ⋯ → Move to trash… Duplicated appears on album cards, list rows and tracks with repeated positive track numbers on the same disc, even when titles differ. Hover over a track badge for the matching reason. Checkboxes appear beside the tracks; nothing is sent yet.
2. Select the copies you want to remove. Upload dates/times and Suggested keep, Suggested trash or Compare manually labels help you compare the copies. Select suggested copies prefers FLAC over MP3, then the newest upload within the same format. Upload dates and formats groups the tracks by day and format on each disc, so two uploads of ten tracks are easier to identify. Nothing is preselected on opening. Tick tracks individually, or use Select extra copies to select each matching title after the first on its disc, regardless of format or date. It leaves differing titles unselected so you can compare and select those manually. The first matching copy stays unselected. Check the selection and change it if you prefer to keep another copy; listen and compare the displayed duration and file format where available. Select all selects the entire album, including tracks without duplicates. The bar shows the selected track count.
3. Choose Review → and confirm the list. Check the titles and count, then choose Move N tracks to the trash. Use Cancel while selecting or Keep them in the review to leave the tracks unchanged.

Tagcast first checks that the selected tracks are still active on their albums, then moves them to iBroadcast's trash and reads the result back. Wait for the checking to finish; Change history shows the result. These tracks leave the active library in Tagcast and other iBroadcast apps. They are never permanently deleted by Tagcast, and your local music files are unchanged. Restore them through iBroadcast's trash; Tagcast cannot restore them. An album disappears from Tagcast when it has no active tracks left.

The stricter title comparison ignores case, spacing and quotation marks. For example, Red Shoes (from the "Dumplin'" Original Motion Picture Soundtrack) and Red Shoes (from the Dumplin' Original Motion Picture Soundtrack) match at the same track number on the same disc. Straight and curly apostrophes also match. Version text such as (Live) or (Radio Edit) remains part of the comparison. At a repeated track number, differing versions receive the Duplicated label and require manual selection; they are not automatically selected as extra copies. A repeated title at track 1 and track 17, or on separate discs, is not a duplicate. Missing track numbers are not matched. Audio files and recording quality are not compared, and the format preference does not prove recording quality or audio identity. The suggestions compare only repeated positive positions on the same disc. Different artists, durations differing by more than two seconds, unknown/incomparable formats, missing dates and tied newest uploads can require manual comparison. Different titles are explicitly flagged even when duration and artist agree. The suggestion keeps unresolved preferred copies; it never chooses an arbitrary winner. Select extra copies retains its separate, stricter title rule and keeps the first.

Step-by-step screenshots: remove duplicate tracks

1. Open ⋯ → Move to trash… on the album. Opening this menu does not select tracks or send a change.

2. Compare repeated track positions. The Faithless example shows Duplicated badges even when title text or artist credits differ.

3. Check uncertain copies manually. Upload timestamps and file formats remain visible. Different artist credits are marked Compare manually; the checked rows below were chosen by the user, not by an automatic suggestion.

4. Choose Review → before confirming. Review the exact tracks and count. Only Move N tracks to the trash sends the change; Keep them closes the review.

Automatic suggestions — earlier interface. This retained BOF Anna example shows upload groups and four suggested copies selected for review. The contributor has already finished automatic duplicate cleanup, so the earlier capture is kept.

Final review — earlier interface. This retained example lists fourteen selected tracks and the explicit confirmation button. The interface styling is older; the review and confirmation steps remain the same.

Split combined album artists in Cleanup

Open Overview → Metadata health → Clean up metadata…, choose Album artists, then Prepare preview. This reads the complete active native library; it does not write to iBroadcast or use a CSV export. Only semicolons split names: commas, slashes and ampersands stay intact.

For Caetano Veloso;Gal Costa, the preview shows Primary: Caetano Veloso and Additional: Gal Costa. Review every proposed disc. Existing separate album artist IDs, roles and credit phrases are preserved; an already separate credit takes precedence over a duplicate generated from the primary name. Combined additional performer credits can also be split, preserving their roles and phrases. Track artists, track credits and other metadata stay unchanged.

Exclude albums to keep their entire displayed sets, check the approval box, then choose Start selected albums. Writes use each original disc's native album ID, followed by read-back. Processing stops on conflicts, request errors or unconfirmed results. Stop/resume and JSON report export remain available; progress counts disc records, while the selection shows affected tracks. No normal metadata History or automatic batch Undo is added.

Album artist cleanup in progress: original screenshot supplied on 18 October 2026, showing an approved run. Confirmed discs have been read back; Sent / checking discs are still awaiting confirmation. The capture shows the source build used to prepare 0.70.0.

The iBroadcast Show Additional Artists and Composers display option may remain off. It does not remove saved credits or gate Tagcast's native reads. New names split from the primary field use the Artist role, which iBroadcast treats as another main artist even with additional roles hidden. Other roles, such as Composer, may be hidden in iBroadcast while remaining available in Tagcast. See the official explanation.

Combine Multi-Disc Album Sets must be disabled in iBroadcast. Tagcast checks this setting, complete active disc membership, album identity and artist names/IDs before writing. Batches affect at most 200 tracks / 20 displayed albums; a native disc over 200 tracks must be edited individually. Invalid names, duplicate primary credits or more than 100 additional credits are blocked visibly. Nothing starts automatically when opening Cleanup or preparing a preview.

See the detailed cleanup instructions.