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.1.0.tar.gz (10.3 kB view details)

Uploaded Source

Built Distribution

image_sorting_tool-0.1.0-py3-none-any.whl (11.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: image-sorting-tool-0.1.0.tar.gz
  • Upload date:
  • Size: 10.3 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.1.0.tar.gz
Algorithm Hash digest
SHA256 8660971eae0d0cf48a8d33494f5a276fce2868a5665c61b846c9267383eaa22b
MD5 6a19f274523bfeacde150afcfab98f5f
BLAKE2b-256 3962aa292b29083870ff947a95c389be3c60363c5669ad0bfffc8ccbfed98693

See more details on using hashes here.

File details

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

File metadata

  • Download URL: image_sorting_tool-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 11.1 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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2239660fff66c7ad019856754d54d15767212e7bfd78287878e49014e95812e1
MD5 4afc9be4ac643280bafdb9e0fbc15144
BLAKE2b-256 0200713a9e42bf2978e096fadec8ee1e79149c1dbb3d5cc595ce7a5acfe57c75

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