Skip to main content

Kill duplicate files, finding partial files as well

Project description

Python version support: CPython 2.6, 2.7, 3.2, 3.3, 3.4 and PyPy.

How it works

killdupes scans your filesystem to find duplicate files, partial files and empty files.

It performs n:n comparison of files through md5 hashing and heavy use of dictionaries. Execute with wildcard, or input file containing file names to check.

The method:

  1. Scan all files, find the smallest.

  2. Read read size amount of bytes (equal to the remaining size of the smallest file, or at most CHUNK size) from all files into records.

  3. Hash all records, use hashes as keys into offsets[current_offset] dict.

  4. Files in the same bucket are known to be equal up to this offset.

  5. Continue until at least two files remain that are still equal at all offsets.

  6. Equal files are either a duplicate case (if they are the same size), or one is partial relative to the other (if not the same size).

Memory consumption should not exceed files_in_bucket * read_size.

The algorithm adapts to file changes; it will read all files until eof regardless of the filesize as recorded at startup.


$ pip install killdupes


$ 'tests/samples/*'
Empty files:
X    0.0  B  14.03.14 17:39:48  tests/samples/empty
=    2.0  B  14.03.14 18:17:43  tests/samples/full
X    1.0  B  14.03.14 18:17:26  tests/samples/partial
=    2.0  B  14.03.14 18:17:43  tests/samples/full
X    2.0  B  14.03.14 18:17:37  tests/samples/full2
Kill files? (all/empty/incompletes/duplicates) [a/e/i/d/N]

If there are many files to scan it will display a progress dashboard while working:

176.1 KB | Offs   0.0  B | Buck 1/1 | File 193868/600084 | Rs   1.0  B

The dashboard fields:

  1. Total bytes read

  2. Current offset of reading

  3. Current number of buckets

  4. File/files in this bucket

  5. Readsize at this offset

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

killdupes-0.1.6.tar.gz (4.9 kB view hashes)

Uploaded source

Built Distribution

killdupes-0.1.6-py2.py3-none-any.whl (8.1 kB view hashes)

Uploaded 2 7

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page