Media sorting tool to organize photos and videos from your camera in folders by year, month and day.
How it works
The software will collect all files from the input directory and copy them to the output directory without changing the files content. It will only rename the files and place them in the proper directory for year, month and day.
All files which are not images or videos or those which do not have creation date information will be placed in a directory called
unknown without file name change. By doing this you can be sure that the input directory can be safely deleted after the successful process completion because all files from the input directory have a copy in the output directory.
sudo snap install phockup
Note: snap applications can access files only in your home and
/media directories for security reasons. If your media files are not located in these directories you should use the installation method below.
If your files are in
/media you should run the following command to allow access:
sudo snap connect phockup:removable-media
Linux (without snap)
If you are using distro which doesn't support snapd or you don't want to download the snap you can use the following commands to download the source and set it up
sudo apt-get install python3 libimage-exiftool-perl -y curl -L https://github.com/ivandokov/phockup/archive/1.5.4.tar.gz -o phockup.tar.gz tar -zxf phockup.tar.gz sudo mv phockup-* /opt/phockup sudo ln -s /opt/phockup/phockup.py /usr/local/bin/phockup
brew tap ivandokov/homebrew-contrib brew install phockup
- Download and install latest stable Python 3
- Download Phockup's latest release and extract the archive
- Download exiftool from the official website and extract the archive
exiftool.exeto phockup folder
- Open Command Prompt and
cdto phockup folder
- Use the command below (use
Organize photos from one directory into another
phockup INPUTDIR OUTPUTDIR
INPUTDIR is the directory where your photos are located.
OUTPUTDIR is the directory where your sorted photos will be stored. It could be a new not existing directory.
phockup ~/Pictures/camera ~/Pictures/sorted
If you want to change the output directories date format you can do it by passing the format as
-d | --date argument.
You can choose different year format (e.g. 17 instead of 2017) or decide
to skip the day directories and have all photos sorted in year/month.
Supported formats: YYYY - 2016, 2017 ... YY - 16, 17 ... MM - 07, 08, 09 ... M - July, August, September ... m - Jul, Aug, Sept ... DD - 27, 28, 29 ... (day of month) DDD - 123, 158, 365 ... (day of year) Example: YYYY/MM/DD -> 2011/07/17 YYYY/M/DD -> 2011/July/17 YYYY/m/DD -> 2011/Jul/17 YY/m-DD -> 11/Jul-17
Missing date information in EXIF
If any of the photos does not have date information you can use the
-r | --regex option to specify date format for date extraction from filenames:
Instead of copying the process will move all files from the INPUTDIR to the OUTPUTDIR by using the flag
-m | --move. This is useful when working with a big collection of files and the remaining free space is not enough to make a copy of the INPUTDIR.
Instead of copying the process will create hard link all files from the INPUTDIR into new structure in OUTPUTDIR by using the flag
-l | --link. This is useful when working with good structure of photos in INPUTDIR (like folders per device).
To run the tests, first install the dev dependencies using
pip install -r requirements-dev.txt
Then run the tests using
- Handle gracefully files without MIMEType
- Handle broken symlinks
SubSecDateTimeOriginalEXIF dates to the list of allowed ones because exiftool changed the default behavior to not include the subseconds for
- Handle filenames with spaces
- Major refactoring.
- Updated all tests.
- Added TravisCI.
-l | --linkflag to link files instead of copy.
-m | --moveflag to move files instead of copy.
- More snapcraft.yaml fixes (removed architecture which were producing wrong snaps for amd64).
- Catch some possible write permission for directories and expand absolute path and home directory on *nix
- Fixed issue with the snap application and simplified the snapcraft.yaml
- Allow different output directories date format with
-d | --dateoption.
- Allow access to removable media (external HDD, USB, etc) for snap the application
- Continue execution even if date attribute is not present [#6]
- Windows compatibility fixes
- Changed synopsis of the script.
-o|--outputdirare not required anymore. Use first argument for input directory and second for output directory.
- Do not process duplicated files located in different directories.
- Suffix duplicated file names of different files. Sha256 checksum is used for comparison of the source and target files to see if they are identical.
- Handle case when
exiftoolreturns exit code > 0.
iglobto support Python < 3.5
- Handle some different date formats from exif data.
- Collect all files instead only specified file types. This also enables video sorting.