imagetools - image library structuring utilities

Imagetools is a set of tools to properly structure (large) image or video libraries. It consists of two main functions:

1. Rename images sequentially based on image tags
2. Date images using a web interface

Installation

There are two supported ways of installing/running imagetools: Using docker and using pip/pipx.

Docker

# Add necessary volumes to the container using the docker run -v option
docker run <image id> imagetools --help

pip

git clone https://git.phntxx.com/bastian/imagetools
cd imagetools

pipx install .

imagetools --help

Usage

Consider the following example of a directory structure for the following usage examples:

.
└── 2023, Rotterdam, Trip
    ├── party.jpg
    ├── food.jpg
    └── central-station.jpg 

For the purpose of this example, all image files do not have a capture date in their metadata (see EXIF tags).

In order to properly sort these files, they should be dated first. So, let's start by dating them:

imagetools date dates.txt 2023,\ Rotterdam,\ Trip

This will start a web server located at http://localhost:5000, which will show the images in random order and allow for you to date them. The dates entered in this process are then stored in dates.txt.

Next, these timestamps can be applied as EXIF tags to the images:

imagetools apply dates.txt

Finally, we can sequentially rename these files:

imagetools rename 2023,\ Rotterdam,\ Trip

This will leave us with the following directory structure:

.
├── dates.txt
└── 2023, Rotterdam, Trip
    ├── 001.jpg
    ├── 002.jpg
    └── 003.jpg 

At this point, dates.txt can be safely deleted.

Contributing

If you want to contribute, just open a pull request.