A set of tools to fix the metadata of your images and videos, find and remove similar images, and organize your folder structure to create a well-structured gallery. All this with simple scripts!
To install the project you must have python 3 installed and added to your path. Once this step is done, you should clone/download this project and run this command in a terminal, in the directory where you have cloned the project:
pip install -r requirements.txt
Notes:
The project has been made with python version 3.11, so its compatibility with later or previous versions is not guaranteed. Also, has been only tested in a Windows machine, so it is also not guaranteed that the results will be optimal in other systems (please, open an issue if that is the case).
If the installation was successful, you are ready to start! To do it, you will have to run the functionality that you want in the following way:
python script.py your_path_to_the_assets --arg1 --arg2 ...
Here you will have to replace script.py for the script that you want.
Organize your photos and videos into a structured folder hierarchy based on their metadata and your preferences. See docs
Identify and remove similar/duplicate images from your gallery to save space and avoid clutter. See docs
Fix the metadata of your images and videos to ensure consistency and accuracy accross different apps. Autocomplete missing dates in the metadata of your files. See docs
For more detailed usage instructions for each script, please refer to their respective docs linked above. There you will have all the details about how to configure each script and what options do you have. As a example, if you want to identify and remove similar images you could use the following command:
python duplicates_remover.py "your_path" --hash_size 32
Keep in mind that you can always use the command python script.py --help or python script.py --h to obtain a brief description of how to use each of the scripts and their respective options
Feel free to improve and optimize the existing code. To contribute to the project, read the previous points carefully and do the next steps with the project:
- Fork it (https://github.com/enrique-lozano/Image-organizer/fork)
- Create your feature branch (
git checkout -b feature/newFeature) - Commit your changes (
git commit -am 'Add some newFeature') - Push to the branch (
git push origin feature/newFeature) - Create a new Pull Request
Feel free to contact the developer if you have any questions or suggestions about the project or how you can help with it.