Copy and Organize Files

This is a Python script that copies files from a source folder to a destination folder based on their modification dates. The script uses the jdatetime module to convert the Gregorian dates to the Persian (Jalali) calendar.

Download

Download for Windows

Requirements

• Python 3.6 or higher
• jdatetime 3.6.4 or higher
• CustomTkinter

Installation

1. Create a virtual environment:

   python -m venv venv

2. Activate the virtual environment:

   • On Windows:

     venv\Scripts\activate

   • On macOS and Linux:

     source venv/bin/activate

3. Install the required packages using pip:

   pip install -r requirements.txt

Usage

1. Run the script:

   python main.py

2. Use the GUI to select the source and destination folders:

   • Click the "Browse" button next to "Origin" to select the source folder.
   • Click the "Browse" button next to "Destination" to select the destination folder.
   • Select the operation mode from the dropdown menu.
   • Optionally, check the "Delete files after copy" checkbox if you want to delete the files after copying.
   • Click the "Copy!" button to start copying files.

3. The script will copy each file from the source folder to a subfolder in the destination folder based on the selected operation mode:

   • Simple Bulk Copy: Copies files without organizing.
   • Copy & Organize (Shamsi): Organizes files into folders based on the Persian (Jalali) calendar.
   • Copy & Organize (Shamsi with Georgian Years): Organizes files into folders based on the Persian (Jalali) calendar with Georgian years.
   • Copy & Organize (Georgian): Organizes files into folders based on the Gregorian calendar.

4. The script will also create a log file named copy.log in the same directory as the script, which records the copying process and timestamps.

Example

Suppose the source folder contains these files:

• DSC_001.jpg (modified on 2023-03-21)
• DSC_002.jpg (modified on 2023-03-22)
• DSC_003.jpg (modified on 2023-04-01)

The destination folder will have these subfolders and files after running the script:

• 1402
  • 4 Farvardin 1402
    • DSC_003.jpg
  • 3 Farvardin 1402
    • DSC_001.jpg
    • DSC_002.jpg

Logging

The script logs the copying process to both the console and a Text widget in the GUI. The log messages are colorized for better readability:

• Timestamp: Cyan
• Operation mode: Red
• Filename: Yellow
• Destination: Yellow

License

This project is licensed under the MIT License.