photo-organizer 1.7.1

A script to organize photos by creation date into year/month/day folders.

Photo Organizer

Photo Organizer is a Python script that sorts photos from a source directory into a target directory based on their creation date. The script can organize photos into year, month, and optionally day subfolders. It also supports copying or moving files, recursive directory traversal, filtering by file extensions, and excluding files using regex patterns.

Features

• Organize photos into year/month/day folders based on creation date
• Move or copy files from the source to the target directory
• Recursively traverse directories
• Filter files by specified extensions
• Exclude files from processing using regex patterns
• Verbose logging for detailed information
• Flexible folder structure with optional top-level year-month folders.

Usage

Prerequisites

• Python 3.x

Installation

Install the package using pip:

pip install photo-organizer

In alternative you can use it with Docker:

docker run -ti \
    -v <your-photo-source-directory>:/source \
    -v <your-photo-target-directory>:/target \
    ghcr.io/Supporterino/photo-organizer:latest /source /target

Running the Script

photo-organizer [-h] [-r] [-d] [-e [ENDINGS [ENDINGS ...]]] [-v] [-c] [--no-year] [--exclude EXCLUDE_PATTERN] source target

Arguments

• SOURCE_DIRECTORY: The source directory containing the photos
• TARGET_DIRECTORY: The target directory where the photos will be organized

Options

• -r, --recursive: Sort photos recursively from the source directory
• -d, --daily: Organize photos into daily folders (year/month/day)
• -e, --endings: Specify file endings/extensions to copy (e.g., .jpg .png). If not specified, all files are included
• --exclude: Provide a regex pattern to exclude matching files from being processed
• -v, --verbose: Enable verbose logging. -vv means more verbose.
• -c, --copy: Copy files instead of moving them
• --no-year: Do not place month folders inside a year folder; place them top-level with the name format YEAR-MONTH
• --no-progress: Disable progress bar for usage in a fully automated environment
• --delete-duplicates: Delete source file if an identical file already exists in the target directory
• --dry-run: Only logs the expected actions and errors but does not modify anything
• --exif: Try to parse the creation date from pictures EXIF data and falls back to creation date

Examples

Move all files from source to target, organizing by year and month:

photo_organizer /path/to/source /path/to/target

Move all files recursively and organize by year/month/day:

photo_organizer /path/to/source /path/to/target -r -d

Copy only .jpg and .png files:

photo_organizer /path/to/source /path/to/target -e .jpg .png -c

Exclude files matching a specific regex pattern:

photo-organizer /path/to/source /path/to/target --exclude "^ignore|\.tmp$"

Enable verbose logging:

photo_organizer /path/to/source /path/to/target -vv

Move photos to top-level year-month folders without a year parent folder:

photo-organizer --no-year /path/to/source /path/to/target

Combine options to copy .jpg and .png files recursively into daily folders with verbose logging:

photo-organizer -r -d -e .jpg .png -vv -c /path/to/source /path/to/target

Development

To contribute to this project, follow these steps:

1. Clone the repository.
2. Install dependencies.
3. Make your changes and add tests.
4. Submit a pull request.

Logging

The script uses Python's logging module to provide detailed information about the operations performed. By default, the logging level is set to INFO. Use the -v or --verbose flag to enable INFO level logging and -v or --verbose --verbose`` for DEBUG` level logging for more detailed output.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request with your changes. Ensure that your code adheres to the existing coding standards and includes appropriate tests.

License

This project is licensed under the MIT License. See the LICENSE file for details.