Skip to content

Simple PyQt6 program that helps you manually sort photos into folders using keyboard shortcuts

License

Notifications You must be signed in to change notification settings

potat-dev/Just-Organize-My-Photos

Repository files navigation

Just Organize My Photos - jomp

A simple PyQt6 program that helps you manually sort photos into folders using keyboard shortcuts.

jomp currently features a minimalist design and basic functionality: sorting photos from one folder into multiple others. Future updates may include additional features such as duplicate detection and corrupted file handling.

Tip

This tool is particularly handy when you've recovered data from a damaged drive, leaving thousands of files jumbled together that need to be neatly reorganized into folders.

Russian version of this README can be found here.

Main screen of the app:

app

Features:

  • Drag-and-drop folder opening.
  • Display of file information: size, date, resolution.
  • Corrupted file detection.
  • Deletion to recycle bin or permanent deletion (Ctrl + Del).
  • Smart file renaming on move (both files are preserved if they have identical names).
  • Folder selection on first button click, or via RMB or Ctrl + LMB.
  • File preview with the ability to open in the default photo viewer (LMB) or file explorer (RMB).

Planned Features:

  • Settings! More settings!!!
  • Hotkey customization and quantity adjustments.
  • More informative (color-coded) photo resolution indicators.
  • Sorting by size/name/resolution.
  • Opening multiple folders simultaneously.
  • Scanning for photos in subdirectories.
  • Option to delete/move all corrupted files at once.
  • Distribution as an executable file.

How to Run

There are two ways to run the application: using Poetry or by building and installing it locally. I recommend the second method because it allows you to run the application from anywhere on your system.

Run Locally with Poetry

  1. Clone the repository:

    git clone https://github.com/potat-dev/just-organize-my-photos.git
    cd just-organize-my-photos
  2. Install dependencies:

    poetry install
  3. Run the application using Poetry:

    poetry run jomp

Building and Installing

  1. Build a distributable wheel file:

    poetry build
  2. Install the application locally:

    pip install .
  3. Now you can run the application from anywhere on your system:

    jomp

    You can also specify the path to the folder you want to sort: --dir /path/to/folder