This document provides simple instructions for using the File Organization Tool to sort, convert, and validate image files.

1. Organize Images: Sort image files into date-based folders (e.g., 2023/January/01).
2. Convert Formats: Automatically convert .heic images to .jpeg if specified.
3. Integrity Check: Validate the integrity of the organized files by ensuring file counts match.
4. Dry-Run: Simulate the process without making actual changes to your files.

• Python 3.7 or newer.

1. Download Python

   • Go to the official Python website.
   • Download the latest version for Windows.

2. Install Python

   • Run the downloaded installer.
   • Ensure the "Add Python to PATH" checkbox is selected during installation.
   • Choose "Install Now" for the default settings.

3. Verify Installation

   • Open Command Prompt (Win + R, type cmd, and press Enter).
   • Run:

     python --version

   • You should see the installed Python version.

4. Install Pip

   • Pip is included by default in modern Python versions. Verify it with:

     pip --version

1. Download Python

   • Visit the official Python website.
   • Download the macOS version.

2. Install Python

   • Open the downloaded .pkg file and follow the on-screen instructions.

3. Verify Installation

   • Open Terminal (Cmd + Space, type Terminal, and press Enter).
   • Run:

     python3 --version

   • macOS uses python3 instead of python.

4. Install Pip

   • Pip is included by default. Verify it with:

     pip3 --version

The tool depends on the following Python libraries:

• pillow_heif
• Pillow
• tqdm

You can install these dependencies using:

pip install -r requirements.txt

Run the script using the terminal:

python photobook.py -s <source_directory> -d <destination_directory> [options]

python photobook.py -s /path/to/source -d /path/to/destination

python photobook.py -s /path/to/source -d /path/to/destination -c

python photobook.py -s /path/to/source -d /path/to/destination --dry-run

python photobook.py -s /path/to/source -d /path/to/destination -i

Organized files will be saved in a structured format:

/destination_directory
└── Images
    ├── 2023_January
    │   └── 2023-01-01
    │       ├── image1.jpg
    │       └── image2.png
    └── Unsorted_Files
        └── <File Type>
            └── unsorted_file1.ext

• Invalid Paths: If a source or destination directory is missing, the tool will alert you and halt execution.
• File Count Mismatch: During integrity checks, the tool stops processing if the source and destination counts do not match.
• HEIC Conversion Failure: If a .heic file fails to convert, it will remain in the unsorted folder.

• Python Documentation
• Installing Python on Windows
• Installing Python on macOS
• Virtual Environments Guide