Skip to main content

Analyse all files in one or more directories and manage duplicate files (the same file present with different names)

Project description


This application help you cleaning your filesystem from duplicate files. The duplicate meaning here is: two or more files have the same content but can have different names.

You can use it in this way:

Usage: [options] [directories]

Analyse all files in one or more directories and manage duplicate files (the
same file present with different names)

  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -a ACTION, --action=ACTION
                        choose an action to do when a duplicate is found.
                        Valid options are print,rename,move,ask; print is the
  -r, --recursive       also check files in subdirectories recursively
  -p PREFIX, --prefix=PREFIX
                        prefix used for renaming duplicated files when the
                        'rename' action is chosen. Default is "DUPLICATED"
  -m PATH, --move-path=PATH
                        the directory where duplicate will be moved when the
                        'move' action is chosen
  -v, --verbose         more verbose output
  -q, --quiet           do not print any messages at all

    Use those options to limit and filter directories and files to check.
    Options belowe that rely on file or directory name support usage of
    jolly characters and can also be used multiple times

    -s MIN_SIZE, --min-size=MIN_SIZE
                        indicate the min size in bytes of a file for being
                        checked. Default is 128. Empty file are always ignored
                        only check directories with this name
                        do not check directories with this name
                        limit the search inside file with that name
                        ignore the search inside file with that name

Report bugs (and suggestions) to <>.


  • More tests coverage (maybe some tests can be merged togheter).

  • Controls recursion maximum depth.

  • Internationalization (at least italian).

  • A “move to trash” action (dependency on trash-cli can be a great idea).

  • Release this as a Debian/Ubuntu/Kubuntu package (I’ll really love this).


  • Thanks to Lord Epzylon for sending me some code and modifications.

Subversion and other

The SVN repository is hosted at the Keul’s Python Libraries



  • The runnable script name has been changed to

  • You can now pass multiple target directories as parameters.

  • Added a –action=ask option for choosing at every duplicate what action perform (interactive mode).

  • Added the –include-dir option for limit the search only to specific directories.

  • Added the –exclude-dir option for skipping the search from some directories.

  • Added the –include-file option for match only some files in the search.

  • Added the –exclude-file option for skipping files from the search, based on file name.

  • Using a wrong directory name was not handled, but was producing only abnormal termination.

  • More kindly handle of the break (CTRL+C) user’s action.

  • Added the –verbose option to print some more message infos.

  • Added the –quiet option to output nothing at all.

  • Removed the _same_file function. Python already have a filecmp module (hoping this is faster)!

  • Added environment for automated tests, and tests too (use the –action=tests).

  • Some fixes to the command line help.


  • Added the move action.

  • Added the –recursive option, to walk an entire tree of folders (thanks to Lord Epzylon).

  • Added the –min-size option, to specify a minimum size of the files to be checked.


  • Bad bug in the Code was ok but the 0.1.1 egg was not installable. Thanks to the everywhere present A. Jung.


  • Fix to the script.

  • Added doc infos.

  • First egg official release.

0.1.0 - Unreleased

  • First (un)release

Project details

Download files

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

Source Distribution

PyDirDuplicateFinder-0.3.0.tar.gz (10.9 kB view hashes)

Uploaded source

Built Distribution

PyDirDuplicateFinder-0.3.0-py2.5.egg (32.0 kB view hashes)

Uploaded 2 5

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