📷 photosort - A pictures/files organizer.

A simple CLI/daemon program to sorts your pictures/files.

Getting started

Let's start by installing photosort.

Installation

You can install photosort using one of the following methods:

# Using cargo
cargo install photosort

# Using docker
docker pull docker.io/negrel/photosort
# or podman
podman pull docker.io/negrel/photosort

Usage

# Print help informations
photosort --help

# Using docker
docker run --rm -it negrel/photosort --help

Sort given /path/to/src1 and /path/to/src2 directories/files recursively using /path/to/dst/:file.name: template. Files and directories are replicated using hardlink and fallback to softlink if the primer fails.

photosort sort -r hardlink -r softlink "/path/to/dst/:file.name:" /path/to/src1 /path/to/src2 ...

Watch directories and sort them as new files are added:

photosort watch --daemon -r hardlink -r copy "/path/to/dst/:file.name:" /path/to/src1 /path/to/src2 ...

Template variables

The following template variables are available for now. If you're missing other variables, don't hesitate to make a PR !

Variable	Description
file.path	Absolute path to file.
file.name	File name.
file.stem	Extracts the stem (non-extension) portion of the filename.
file.extension	Extracts the extension part of the filename.
file.name.date	Parse RFC3339 date from filename (with optional separator: - _)
file.name.date.year	Year extracted from filename.
file.name.date.month	Month extracted from filename.
file.name.date.day	Day extracted from filename.
file.md.creation_date	File creation date in RFC3339 format.
file.md.creation_date.year	Year extracted from file creation date.
file.md.creation_date.month	Month extracted from file creation date.
file.md.creation_date.day	Day extracted from file creation date.
exif.date	Exif date in RFC3339 format.
exif.date.year	Year extracted from DateTime exif field.
exif.date.month	Month extracted from DateTime exif field.
exif.date.day	Day extracted from DateTime exif field.

Composed template variables

The following composed template variables are available for now:

Variable	Source variables	Description
date	exif.date -> file.name.date -> file.md.creation_date	Date in RFC3339 format.
date.year	exif.date.year -> file.name.date.year -> file.md.creation_date.year	The full proleptic Gregorian year, zero-padded to 4 digits.
date.month	exif.date.month -> file.name.date.month -> file.md.creation_date.month	Month number (01–12), zero-padded to 2 digits.
date.day	exif.date.day -> file.name.date.day -> file.md.creation_date.day	Day number (01–31), zero-padded to 2 digits.

Contributing

If you want to contribute to photosort to add a feature or improve the code contact me at negrel.dev@protonmail.com, open an issue or make a pull request.

🌠 Show your support

Please give a ⭐ if this project helped you!

📜 License

MIT © Alexandre Negrel