Mediarizer
Fast and easy organisation of photos / videos by date
Lightweight, fast and runs on all harware and OS
Building, Installing and Using Mediarizer
Prerequisites
- Make sure you have downloaded
g++(on macOSclang++which is installed alongside Xcode). - Download and install Exiv2 on your computer.
(!) if you want to sort videos as well do not forget to addcmake .. -DEXIV2_VIDEO_ENABLE=Onflag when building - WIP: If you want to achieve better performance you should download OpenMP for multithreading.
(!) Keep in mind that Mediarizer interacts with the filesystem so there will be only a slight performance improvement as the main bottleneck is the I/O
Build
-
Open a terminal windows and clone Mediarizer and move to directory
$ git clone https://github.com/keybraker/Mediarizer.git && cd Mediarizer
-
Compile Mediarizer
$ make
-
Run Mediarizer (examples)
$ ./mediarizer ...
Clean
-
In the Mediarizer folder type
$ make clean
Usage Guide
Flags
| Name | Acronym | Argument | Description | State | Mandatory |
|---|---|---|---|---|---|
| -input | -i | path / file | gives path to file or directory | working | yes |
| -output | -o | path | path to output directory | working | yes |
| -type | -t | tp1, tp2, .. | _organizes only given file type/s(image, video) | working | no |
| -photo | -p | none | organizes only photos | working | no |
| -video | -v | none | organizes only videos | working | no |
| -recursive | -r | none | recursively process sub-directories | working | no |
| -date | -D | none | if image has no exif date filesystem data is used | no | no |
| -move | -m | none | move photos that have no metadata to to undetermined folder | working | no |
| -write | -w | none | will add exif data to image that has none | no | no |
| -delete | -x | none | deletes files in source directory | no | no |
| -duplicate | -d | none | duplicates are moved into duplicate folder in move directory | no | no |
| -help | -h | none | displays a usage guide of Mediarizer | working | no |
| -version | -V | none | displays current version | working | no |
| -verbose | -s | none | outputs execution information while running | working | no |
a. Multiple flags can be used in conjunction
b. Multiple file types(image, video) can be used as comma-separated string ex: -type jpg,png
c. Duplicate photos are compared by type, size, date and resolution, only than are they categorized as same
Examples
-
sort single file
$ ./mediarizer -i /path/media.file -o /path/to/store/folder $ ./mediarizer --input /path/media.file --output /path/to/store/folder
-
sort directory
$ ./mediarizer -i /path/folder -o /path/to/store/folder $ ./mediarizer --input /path/folder --output /path/to/store/folder
-
sort directory and encapsulated directories
$ ./mediarizer -i /path/folder -o /path/to/store/folder -r
-
flags can be used in any order
$ ./mediarizer -o /path/to/store/folder -D -i /path/source/folder -f mp4,jpg,png
-
this execution will only sort mp4 and jpg files to move direcotry
$ ./mediarizer -i /path/source/folder -o /path/to/store/folder -f mp4,jpg
-
will only copy photos, not videos:
$ ./mediarizer -i /path/source/folder -o /path/to/store/folder -photo
Additional Information
a. photos without exif data can be organized with date of creation in the file system using flag
-D
b. when two photos have the same name, only the first encountered is moved to new directory
c. unsupported files are not being copied
d. corructed files may cause the program to crash
e. using cloud storage services like (iCloud, OneDrive, Dropbox, etc) may result in unexpected behaviour as data is actually only on remote servers and you locally can see a shortcut of the remote file
if you encounter any problem or error, please report it.
if you want to contribut please follow the guidelines.
Information
Release History
| Version | Date | Argument |
|---|---|---|
| v2.0.0 | 08-12-2020 | Refactored project and used Exiv2 |
| v1.7.0 | 22-08-2017 | Memory added, for stop and restart |
| v1.6.0 | 20-08-2017 | Fully functional duplication deletion (BETA) |
| v1.5.0 | 19-08-2017 | Added duplication deletion |
| v1.1.2 | 18-08-2017 | Added -flags for a more controlled organisation |
| v1.1.1 | 17-08-2017 | Now photos and videos are separated in to diffrent folders for maximum organisation |
| v1.1.0 | 17-08-2017 | Huge improvement using ExifTool as processing tool |
| v1.0.0 | 12-08-2017 | Full jpeg release with the help of easyexif |
| v0.1.0 | 09-08-2017 | Initial commit |
Acknowledgments - Exiv2
Author - Ioannis Tsiakkas - Keybraker
License - GNU LICENSE
Copyrights © Keybraker 2020-2021 Mediarizer, All rights reserved