Skip to main content

unduplicate-itunes

Upload Python Package

Moves duplicate song files from your iTunes music directory to the trash.

iTunes doesn't automatically remove missing songs, so after you use this package to delete them, follow these instructions.

Depending on the structure of your iTunes music directory, it's possible that some duplicate files will be untouched while their original counterparts will be deleted instead (e.g. song.mp4 is removed, song 1.mp4 survives). Although, duplicates and originals look identical in iTunes regardless so this problem only matters if you care about the file names.

Behavior

  • You are prompted to make a backup of your iTunes music directory before executing. Even if you don't, you can still restore your files from the trash after the script is finished.
  • You are prompted with the number of duplicates to be removed before executing.
  • Directories (usually albums folders) that only contain duplicate files will be moved to the trash.
  • A log file of all actions is output once the script finishes. It is created in whatever cd you have your terminal set to.

Install (PyPi)

pip install unduplicate-itunes

Usage

Using remove_by_artist_and_title.py

cd into any directory (the log file will be dumped here)

python
from unduplicate_itunes import remove_by_artist_and_title as undup
undup.main()

When you are prompted to enter the iTunes music directory, you can find the path by right clicking on any song in iTunes and select Show in Windows Explorer or Show in Finder (macOS). Grab the root folder that contains all the artist folders.

There are other scripts included that try to find duplicates by other methods but they are unfinished and aren't as effective at finding all duplicates.

Cleanup iTunes songs

Once the files are trashed, you can remove the dead songs from iTunes using these instructions here.

Metadata

Release files for unduplicate-itunes 1.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for unduplicate-itunes 1.0.2
File Size Uploaded
unduplicate_itunes-1.0.2.tar.gz 5.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for unduplicate-itunes 1.0.2
File Interpreter ABI Platform
unduplicate_itunes-1.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 13.9 kB

Release files / unduplicate_itunes-1.0.2.tar.gz

Download URL unduplicate_itunes-1.0.2.tar.gz
Size 5.8 kB
Tags Source
SHA-256 checksum
How to use checksums
ba4342f1db12ffc15e3ae96ff69148903f4260d1c45a29fb77eeaa17fd8cf53d
BLAKE2b-256 checksum
How to use checksums
973b005fa0196cc9b792f405ad03a06f2f1e05ed8739d9ee53857c376524a88e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.16

Release files / unduplicate_itunes-1.0.2-py3-none-any.whl

Download URL unduplicate_itunes-1.0.2-py3-none-any.whl
Size 8.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5e38db0378dcca39994dd4c1b1b48de29262b3d6501f1d592380a7eb8f4f435b
BLAKE2b-256 checksum
How to use checksums
d335b98ac37c5996ce8ec36061586886d17972089da7ea619b24943495da03d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.2 CPython/3.9.16

Release history Release notifications | RSS feed

This release

1.0.2 This release

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page