In the digital age, managing our files effectively is as crucial as keeping our physical spaces organized. One common challenge is dealing with duplicate files that consume unnecessary space and create clutter. Fortunately, Python, with its powerful libraries and simple syntax, offers a practical solution. Today, we’ll explore a Python script that helps you identify and list all duplicate files in a specified directory.

The Digital Clutter Dilemma

Duplicate files are often the unseen culprits of diminished storage space and disorganized file systems. Whether they're documents, images, or media files, these duplicates can accumulate over time, leading to confusion and inefficiency.

Python to the Rescue

Python is a versatile programming language that excels at automating repetitive tasks, like identifying duplicate files. In this post, we'll introduce a script that utilizes Python's capabilities to simplify your digital cleanup efforts.

The Script: How It Works

Here is the script:

import os
import hashlib

def generate_file_hash(filepath):
    hash_md5 = hashlib.md5()
    with open(filepath, "rb") as f:
        for chunk in iter(lambda:, b""):
    return hash_md5.hexdigest()

def find_duplicate_files(directory):
    hashes = {}
    duplicates = []

    for root, dirs, files in os.walk(directory):
        for file in files:
            path = os.path.join(root, file)
            file_hash = generate_file_hash(path)

            if file_hash in hashes:
                duplicates.append((path, hashes[file_hash]))
                hashes[file_hash] = path

    return duplicates

if __name__ == "__main__":
    directory_path = 'path/to/your/directory'  # Replace with your directory path
    duplicate_files = find_duplicate_files(directory_path)

    if duplicate_files:
        print("Duplicate files found:")
        for dup in duplicate_files:
            print(f"{dup[0]} is a duplicate of {dup[1]}")
        print("No duplicate files found.")

The script operates in several steps:

Calculating File Hashes: It begins by calculating the MD5 hash of each file in the directory. MD5 hashes are unique to the file's content, making them ideal for identifying duplicates.

Traversing the Directory: The script uses os.walk to traverse through the given directory, processing each file it encounters.

Identifying Duplicates: As it processes each file, the script checks if its hash matches any previously encountered file. If a match is found, it's identified as a duplicate.

Reporting the Results: Finally, the script lists all duplicate files, providing their locations for easy reference.

To run the script, you'll need Python installed on your system. No additional libraries are required as it uses modules available in Python's standard library.

Practical Applications

This script is particularly useful for:

  • Cleaning up personal directories like Downloads or Documents.
  • Managing large collections of files where duplicates are likely.
  • Preparing data for backups or migrations.


This Python script offers a straightforward and effective approach to tackling the common problem of duplicate files. By automating this process, Python not only saves you time but also helps in maintaining a more organized digital space.

Thank you for reading and I will see you on the Internet.

This post is public so feel free to share it.

If you like my free articles and would want to support my work, consider buying me a coffee:

Are you working on a project that’s encountering obstacles, or are you envisioning the next groundbreaking web application?

If Python, Django, and AI are the tools you're exploring but you need more in-depth knowledge, you're in the right place!

Get in touch for a 1-hour consultation where I can address your specific challenges.

Developer Service Blog - 1 Hour Consulting - Nuno Bispo
Are you working on a project that’s hitting roadblocks or simply dreaming up the next big web application?

Tagged in: