photo-organizer 1.0.0

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, and filtering by file extensions.

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
• Verbose logging for detailed information

Usage

Prerequisites

• Python 3.x

Installation

Install the package using pip:

pip install photo-organizer

Running the Script

photo_organizer SOURCE_DIRECTORY TARGET_DIRECTORY [OPTIONS]

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
• -v, --verbose: Enable verbose logging
• -c, --copy: Copy files instead of moving them

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

Enable verbose logging:

photo_organizer /path/to/source /path/to/target -v

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 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.