📸 Photo Utils

A collection of Python utilities to organize photos and other media

Why?

These days many of us have large, messy media libraries split between multiple drives and cloud storage. Organizing these can be very difficult, but Python can help!

Key Problems to Solve

• De-duplication of media files
• Correct the dates on files downloaded in bulk from Google Photos
• Consistently name files for better organization and sorting

Usage

The main entrypoint for usage is the CLI which you can access by running

python cli.py --help

Suggested Command Order

1. Backup all your media first
2. Collect your messy media into one folder (Note that you should avoid putting too many files in one folder, so consider chunking the content you plan on processing)
3. Run commands with --dry-run set first just to ensure nothing unwanted will happen
4. Run python cli.py find-duplicates --path PATH_TO_FOLDER. Check out the flagged files and delete any you want to!
5. Then run python cli.py correct-file-types --path PATH_TO_FOLDER
6. Then run python cli.py correct-file-dates --path PATH_TO_FOLDER
7. Then run python cli.py normalize-file-names --path PATH_TO_FOLDER

Testing

pytest

or

coverage run -m pytest