🎵 RepetiScan - Duplicate MP3 Finder

RepetiScan Music is a desktop Python app designed to help you find duplicate or similar MP3 songs in your local music library. It compares files based on their titles and groups them when they are similar. You can delete songs (safely sent to recycle bin), export results to CSV, and filter by artist name.

Key Features
  • Search for:
    • Title similarity by percentage
    • Keyword-based match
  • Exclude songs by a specific artist
  • blacklist words
  • Group similar songs in a single row
  • Play songs with your default media player
  • Delete songs (sent to recycle bin, not permanently erased!)
  • Export results to .csv file
  • User interface (GUI) using Tkinter
  • Right-click support, multi-selection, and horizontal scrolling
  • Supports file names and ID3 tags (title, artist)
How to Download
  1. Download the latest version of RepetiScan from the Latest Release.
  2. Extract the contents of the downloaded file and run RepetiScan.music.exe.

previous Releases

How to Use
  1. Open the RepetiScan.music.exe app.
  2. Select the folder containing your MP3 files.
  3. Adjust the blacklist (optional).
  4. Search for duplicate songs (range or word match).
  5. double-click on a column songs.
  6. play the song and delete
How Works

RepitiScan Music is a tool for analyzing MP3 files and detecting duplicate or very similar songs in a folder. It uses two methods: one based on the percentage of similarity between titles and another based on the number of words in common. In addition, it allows you to exclude specific words (such as “remastered” or “live”) using an editable blacklist within the application itself. It also includes features to filter songs by artist, play them with a double click, move them to the trash, or export the results to a CSV file. Ideal for organizing music libraries with inconsistent names.

How Build
  1. Install Python 3.11.9 or later.
  2. Clone the repository: 
    git clone https://github.com/Cristioro/RepetiScan.git
cd RepetiScan
  3. Install the required libraries using pip: 
    pip install -r requirements.txt
  4. Run the build.bat script to create the executable: 
    start build.bat