exif_renamer 0.2.3

Rename photos in given directory to their EXIF DateTimeOriginal, and viceversa. Defaults to YYYYMMDD_hh24mmss format.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132

# Rust EXIF Renamer

[![GitHub Release](https://img.shields.io/github/v/release/pirafrank/rust_exif_renamer)](https://github.com/pirafrank/rust_exif_renamer/releases/latest)
[![Crates.io](https://img.shields.io/crates/v/exif_renamer)](https://crates.io/crates/exif_renamer)
[![Crates.io MSRV](https://img.shields.io/crates/msrv/exif_renamer)](https://github.com/pirafrank/rust_exif_renamer/blob/main/Cargo.toml)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

[![CI-CD](https://github.com/pirafrank/rust_exif_renamer/actions/workflows/ci.yml/badge.svg)](https://github.com/pirafrank/rust_exif_renamer/actions/workflows/ci.yml)
[![Release](https://github.com/pirafrank/rust_exif_renamer/actions/workflows/release.yml/badge.svg)](https://github.com/pirafrank/rust_exif_renamer/actions/workflows/release.yml)

A simple cross-platform photo renamer and data editor. It renames JPEG files based on the `DateTimeOriginal` in their EXIF metadata, and viceversa.

It processes in parallel all files in the given folder. If anything fails, it prints an error message and continues with the next file.

It defaults into using the `YYYYMMDD_hh24mmss` pattern. Use the `--pattern` option to change it (but use 24h format).

Written in Rust.

## Install

### Binary

Download the binary from [latest release](https://github.com/pirafrank/rust_exif_renamer/releases/latest) and move to `PATH`.

### Homebrew

```sh
brew tap pirafrank/tap
brew install exif_renamer
```

### cargo

```sh
cargo install exif_renamer
```

### binstall

If you have [binstall](https://github.com/cargo-bins/cargo-binstall), you can get the binary using `cargo` and skip compilation.

```sh
cargo binstall exif_renamer
```

### From source

Build and install to `$HOME/.cargo/bin` compiling from source. You need to have [Rust](https://www.rust-lang.org/) installed.

```sh
cargo install --locked --git https://github.com/pirafrank/rust_exif_renamer --tag VERSION
```

Note: Replace `VERSION` with the desired version to install. Not specifying a tag will install from `main` branch. `main` branch should be stable, but it's unreleased software and may contain bugs or breaking changes. It should considered beta quality software.

## Update

Download the new binary version and overwrite old one.

If you have installed via `cargo`, then re-run the `cargo install` command specifying the new tag.

## Usage

```txt
Usage: exif_renamer.exe [OPTIONS] --path <PATH> <COMMAND>

Arguments:
  <COMMAND>
          Command to execute

          Possible values:
          - exif-to-filename: Rename files based on EXIF data
          - filename-to-exif: Update EXIF data based on filename

Options:
  -p, --path <PATH>
          Directory containing the images to process

  -P, --pattern <PATTERN>
          Date format pattern to parse from or set to filename

          [default: %Y%m%d_%H%M%S]

  -h, --help
          Print help (see a summary with '-h')

  -V, --version
          Print version
```

### Examples

Use EXIF data to rename all JPEG files in some folder:

```sh
exif_renamer exif-to-filename --path somefolder
```

Use filename pattern to set DateTimeOriginal in EXIF data for all JPEG files in some folder:

```sh
exif_renamer filename-to-exif --path somefolder
```

## To Do

0.1.0

- [x] Rename files based on EXIF data

0.2.x

- [x] Cross-platform support
- [x] Reverse mode: set DateTimeOriginal based on filename
- [x] Add `--pattern` option
- [x] Improve help and version options
- [ ] Add colored output
- [x] CI pipeline
- [x] Release binaries via pipeline
- [ ] Unit tests

0.3.x

- [ ] TUI/GUI

## Guarantee

This software is provided "as is", without any guarantee. Use at your own risk.

## License

This software is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).