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

Uploaded Source

Built Distribution

image_sorting_tool-0.0.4-py3-none-any.whl (10.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: image-sorting-tool-0.0.4.tar.gz
  • Upload date:
  • Size: 9.5 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.4.tar.gz
Algorithm Hash digest
SHA256 94ddd143ea26bc19ecba2248fa6a0aee5031e0e9985d8dfff4dd666b87d17616
MD5 7c388c101181a801e4940eef2828ff58
BLAKE2b-256 ff8bedad60425485c69a79c3a1a707b4b8b15ded7c797dfc31be99b7b6bf7715

See more details on using hashes here.

File details

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

File metadata

  • Download URL: image_sorting_tool-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 10.2 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 38aabdb7361d0c02718ae113ba00beb056581eec2176630af75957711f2048a5
MD5 b4cc65d6752208d3e2971540f2944fe8
BLAKE2b-256 56a26131d4c3c2ec6de1027ab6187789610ed61105a60e7188800d94135cac9a

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