exipicrename2

Python3 script for renaming pictures (and matching (raw, xml, txt, ..) files) on base of embedded exif / iptc data - date, camera name, serial numbers e.g.

reads exif data from pictures and rename them

used exif tags are:

• DateTimeOriginal
• DateTimeOriginal
• FNumber
• ExposureTime
• FocalLength
• Model
• ISOSpeedRatings

Python Versions: Python 3.8 - Python 3.13beta (with older - but insecure - Pillow Version less or equal 9.4 also Python 3.7)

Operating Systems: Developed on and for Linux (OpenSuse, Ubuntu, should work on any Linux with Python), Unit-Tests indicate it could also used on MacOS and Windows (see Github Actions).

No warranty this is working for you, too.

Please make a backup of your files before using this script.

This program needs the Python library "Pillow" (will be installed if you use the install process).

See also: requirements.txt

Installation

System wide installation

Install with python3 setup.py install to your Python environment (you might need to use your root (sudo) / Admin for this). Necessary libraries should be installed automagically (on Linux: exipicrename will be probably installed to /usr/bin/expicrename).

or

Individual user installation

python3 setup.py install --user will install it to your user's python path (On Linux e.g. $HOME/.local/lib/python3.7/site-packages/). Necessary libraries should be installed automagically.

Linux (and probably MacOS): For the script exipicrename you could add $HOME/.local/lib/exipicrename to your $PATH ( for bash put following line to .bashrc: export $PATH=$PATH:/$HOME/.local/lib/expicrename ). (Or do create a symlink to $HOME/bin)

or

Manual installation

• install python3-pillow (pip, system package)
• copy / symlink exipicrename.py to your favourite $PATH

Usage

exipicrename {options} [files]
options:

  -h, --help            show this help message and exit
  -d, --datedir         sort and store pictures to sub-directoriesdepending on
                        DateTimeOriginal (YYYY-MM-DD)
  -o, --ooc             use .ooc.jpg as filename extension (for Out Of Cam
                        pictures)
  --oocstring OOCSTRING
                        use string as additional extension, don't forget the
                        '.' as delimiter
  -s, --short, --short-names
                        use short names: only date + serial number, no
                        exhaustive camera data
  -n, --simulate, --dry-run
                        don't rename, just show what would happen
  -V, --version         show the version and exit
  -v, --verbose
  -q, --quiet, --silent

Copyright (c) 2019,2024 Hella Breitkopf, https://www.unixwitch.de

MIT License -> see LICENSE file