Go to file
Hashim 442640b43b Merge branch 'master' of https://github.com/tfrdidi/sort-PhotorecRecoveredFiles into tfrdidi-master 2022-04-04 21:28:44 +01:00
.gitignore added parameter "keep filename" 2017-11-30 22:20:36 +01:00
jpgSorter.py min event delta is configurable via parameter now =) 2017-11-30 22:48:57 +01:00
numberOfFilesPerFolderLimiter.py Make indentation style consistent (all spaces now). 2017-11-25 19:24:30 +01:00
readme.md Merge branch 'master' of https://github.com/tfrdidi/sort-PhotorecRecoveredFiles into tfrdidi-master 2022-04-04 21:28:44 +01:00
recovery.py Fix SyntaxWarning in recovery.py 2021-06-26 20:00:38 +08:00

readme.md

Sort files recovered by Photorec

Photorec does a great job when recovering deleted files. But the result is a huge, unsorted, unnamed amount of files. Especially for external hard drives serving as backup of all the personal data, sorting them is an endless job.

This program sPRF helps you sorting your files. First of all, the files are copied to own folders for each file type. Second, jpgs are distinguished by the year, and optionally by month as well when they have been taken and by the event. We thereby define an event as a time span during them photos are taken. It has a delta of 4 days without a photo to another event. If no date from the past can be detected, these jpgs are put into one folder to be sorted manually.

Origin and Credits

This is a fork of tfrdidi's much-improved fork of Chris Masterson's sort-PhotorecRecoveredFiles. The code of this version is unchanged from tifrdidi's version, and was created purely for the purpose of enabling issue tracking and logging the issues I've come across during usage in the hope that someone more adept than me at Python either fix them or contribute to them. The bulk of this readme was also written by tfrdidi, and I improved the English slightly for the purpose of making it clearer.

Installation

First install the package exifread:

pip install exifread

Run the sorter

Then run the sorter:

python recovery.py <path to files recovered by Photorec> <destination>

This copies the recovered files to their file type folder in the destination directory. The recovered files are not modified. If a file already exists in the destination directory, it is skipped. This means that the program can be interrupted with Ctrl+C and then continued at a later point by running it again.

The first output of the programm is the number of files to copy. To count them might take some minutes depending on the amount of recovered files. Afterwareds you get some feedback on the processed files.

Parameters

For an overview of all arguments, run with the -h option: python recovery.py -h.

Max numbers of files per folder

All directories contain a maximum of 500 files by default. If there are more for a file type, numbered subdirectories are created. If you want another file-limit, e.g. 1000, pass that number as the third parameter when running the program:

python recovery.py <path to files recovered by Photorec> <destination> -n1000

Folder for each month

sPRF usually sorts your photos by year:

destination
|- 2015
    |- 1.jpg
    |- 2.jpg
    |- ...
|- 2016
    |- ...

Sometimes you might want to sort each year by month:

python recovery.py <path to files recovered by Photorec> <destination> -m

Now you get:

destination
|- 2015
    |- 1
      |- 1.jpg
      |- 2.jpg
    |- 2
      |- 3.jpg
      |- 4.jpg
    |- ...
|- 2016
    |- ...

Keep original filenames

Use the -k parameter to keep the original filenames:

python recovery.py <path to files recovered by Photorec> <destination> -k

Adjust event distance

For the case you want to reduce or increase the timespan between events, simply use the parameter -d. The default is 4: python recovery.py <path to files recovered by Photorec> <destination> -d10