Dave: rename Path Hash to File Hash (CM_Key_ID_HASH_FILE)

2026-06-07T21:46:53Z

rename Path Hash to File Hash (CM_Key_ID_HASH_FILE)

← Older revision		Revision as of 21:46, 7 June 2026
Line 11:		Line 11:
	== What the command does ==		== What the command does ==

	# Computes a '''~~Path~~ Hash''' for each library song that has a resolvable local media path (ZIP, then video, then audio — same priority kJams uses elsewhere).		# Computes a '''File Hash''' for each library song that has a resolvable local media path (ZIP, then video, then audio — same priority kJams uses elsewhere).
	# Groups songs with the same hash (same resolved file path).		# Groups songs with the same hash (same resolved file path).
	# Within each group, keeps the entry with the '''lowest song ID''' as the canonical copy.		# Within each group, keeps the entry with the '''lowest song ID''' as the canonical copy.
Line 27:		Line 27:
	* Duplicates defined only by playlist references without duplicate library entries.		* Duplicates defined only by playlist references without duplicate library entries.

	== ~~Path~~ Hash column ==		== File Hash column ==

	After running, you can show the '''~~Path~~ Hash''' sort column in the Library to inspect the computed values. Songs with the same hash are duplicates by file path.		After running, you can show the '''File Hash''' sort column in the Library to inspect the computed values. Songs with the same hash are duplicates by file path.

	== Before you run ==		== Before you run ==

Dave: add Remove Duplicate Index Entries help page

2026-06-07T01:41:27Z

add Remove Duplicate Index Entries help page

New page

= Remove Duplicate Index Entries =

This feature is available in the Qt (64-bit) edition of kJams under '''Advanced → Special → Remove Duplicate Index Entries…'''.

== What is an "index entry"? ==

Each song in your kJams '''Library''' has a unique '''song ID''' (index entry). That is separate from a '''playlist item''' (a reference to a song in a rotation list, custom playlist, singer list, etc.).

Sometimes the same physical media file is imported or added more than once, creating multiple library index entries (different song IDs) that all point at the '''same file on disk'''. This command finds those duplicates and consolidates them.

== What the command does ==

# Computes a '''Path Hash''' for each library song that has a resolvable local media path (ZIP, then video, then audio — same priority kJams uses elsewhere).
# Groups songs with the same hash (same resolved file path).
# Within each group, keeps the entry with the '''lowest song ID''' as the canonical copy.
# '''Updates playlists''': any playlist reference to a removed song ID is changed to point at the canonical song ID. If the playlist already contains the canonical entry, the duplicate playlist reference is removed instead.
# '''Deletes''' the extra library index entries (and their library playlist rows). Your media file on disk is not deleted by this operation (only cache/temp files associated with the removed entries may be cleared, same as normal Remove from Library).

== What is skipped ==

Songs with '''no resolvable local file path''' are skipped — for example some streaming entries, some music-store entries without a local file, or songs whose files are missing. They are not hashed and are never merged or deleted by this command.

== What this does '''not''' detect ==

* The same audio on disk via '''different paths''' (aliases, copies in different folders, hard links with different path strings).
* Duplicates that share metadata (name/artist/album) but point at '''different files'''.
* Duplicates defined only by playlist references without duplicate library entries.

== Path Hash column ==

After running, you can show the '''Path Hash''' sort column in the Library to inspect the computed values. Songs with the same hash are duplicates by file path.

== Before you run ==

* '''Back up your library''' (Save Database) if you are unsure. This operation removes library entries and cannot be undone from within kJams.
* Quit any operation that is sorting the library; the command waits for sorting to finish.
* Read the confirmation dialogs carefully; the second dialog shows counts of groups and entries to be removed.

== Technical notes ==

* Path resolution uses '''Resolve As Far As You Can''' so aliases and broken path chains are normalized when possible.
* Volume names are normalized for consistent hashing on macOS.
* The feature is compiled only into the Qt build (`#if _QT_`); 32-bit editions do not include this menu item.

Remove Duplicate Index Entries - Revision history

Dave: rename Path Hash to File Hash (CM_Key_ID_HASH_FILE)

Dave: add Remove Duplicate Index Entries help page