renamer-media-date-time

This is a renamer replace chain plugin - see this tutorial to learn how to use renamer plugins.

Replaces the filename of image and video files with the creation date in the following format: yyyyMMdd_HHmmss.{ext} based on EXIF data.

⚠️ Requires exiftool to be installed.

Install

npm install -g renamer renamer-media-date-time

Usage

Remove the --dry-run flag to rename the files on disk.

Supported file formats: .jpg, .png, .gif, .bmp, .heic, .mp4, .mov.

$ tree
.
├── one.jpg
└── two.mp4

0 directories, 2 files

$ renamer --chain renamer-media-date-time --dry-run *

✔︎ one.jpg → 20240429_132557.jpg
✔︎ two.mp4 → 20240429_132557.mp4

Rename complete: 2 of 2 files renamed.

$ tree -N
.
├── 20240429_132557.jpg
└── 20240429_132557.mp4

0 directories, 2 files

## Development

- Run tests locally:

```bash
npm install
npm run test

• CI runs on GitHub Actions for pushes and PRs. Coverage is generated via Vitest and the badge above is automatically updated.