Skip to main content

Graphical tool to sort images into a folder structure based on the date the images were taken

Project description

Image Sorting Tool

Build Status PyPI version PyPI license
Screenshot This is a simple python tool that will find all the images in a source directory (including sub-directories) and copy them into a structured destination.

The date taken for each image will be extracted from the exif data and the image destination name will be by default in format 'yyyymmdd-HHMMSS'. For example '20201225-234532.jpg' The default output structure is for sorted images to be placed in year and month folders. For example:

/
├── 2019/
    ├── 07/
        ├── 20190712-141507.jpg
        └── 20190719-224521.jpg
    └── 10/
        ├── 20191011-180520.jpg
        └── 20191029-204731.jpg
└── 2020/
    ├── 01/
        └── 20200114-135312.jpg
    └── 03/
        └── 20200301-110330.jpg

Images that do not have EXIF data available will be copied to a 'failed_to_sort' folder in the root directory of the above directory structure without any renaming.

This tool is multithreaded to increase performance on high speed storage such as SSDs.

No data in the source directory is altered. It is only read from and then copy operations are performed during the sorting process.

Installation

The tool can be run on Linux, MacOS and Windows provided the following requirements are met

Requirements

  • Python 3.5 or above
  • python3-tk (Comes with Python 3, but may need installing seperately in linux)

Install by running the following in a console

pip install image-sorting-tool

Usage

Run the following to launch

image-sorting-tool

Upgrading

Run the following to upgrade

pip install --upgrade image-sorting-tool

Uninstalling

Run the following to remove the tool from your machine

pip uninstall image-sorting-tool

Development

To contribute, install the dev dependencies with

pip install .[dev]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

image-sorting-tool-0.0.3.tar.gz (7.6 kB view details)

Uploaded Source

Built Distribution

image_sorting_tool-0.0.3-py3-none-any.whl (9.0 kB view details)

Uploaded Python 3

File details

Details for the file image-sorting-tool-0.0.3.tar.gz.

File metadata

  • Download URL: image-sorting-tool-0.0.3.tar.gz
  • Upload date:
  • Size: 7.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for image-sorting-tool-0.0.3.tar.gz
Algorithm Hash digest
SHA256 abe8cd16f065fc4036c063e4fd603bb3bf3a5e2fb06ce8dd2ce27e324a35eeee
MD5 c098ac5931b769a4c268f9c0b4450735
BLAKE2b-256 e62291a02025ad1f275d0ea3a0ac89981f2c1083d92d23981784253bec547f22

See more details on using hashes here.

File details

Details for the file image_sorting_tool-0.0.3-py3-none-any.whl.

File metadata

  • Download URL: image_sorting_tool-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 9.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/50.3.0 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.8.5

File hashes

Hashes for image_sorting_tool-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 3c4f7cacdb1b5f8958ee7a0165db45e9bb3868ece7c9766b1b4d9700d7aee663
MD5 821eba2b0832841a695727a494c96081
BLAKE2b-256 2fbb8d66c64becaecf9f348e431b6e55610f9e319a2e566bed86b49678aca3ce

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page