Media Group Renamer 🖼️📹

A CLI tool to organize media files by timestamp and geolocation metadata

Demo

Features

• Groups media files by time and location metadata
• Configurable time window (default 15 minutes)
• Configurable distance threshold (default 100 meters)
• Supports common photo/video formats
• Prevents filename conflicts
• Preserves file extensions

Installation

npm install -g content-renamer

Usage

Interactive Mode

content-renamer --interactive

OR Simply write

content-renamer --i

Non-Interactive Mode

content-renamer <directory> [duration_minutes] [distance_meters]

Examples

1. Organize photos in the ~/Pictures folder:

# Basic usage with defaults
content-renamer --directory ~/Pictures

2. Group files with a 30-minute window and 200-meter distance:

content-renamer --directory ~/Videos --duration 30 --distance 200

3. Use interactive mode:

content-renamer --interactive

4. Organize files in a relative path:

content-renamer --directory ../Trip/Photos

Configuration

| Parameter | Default | Description | |-----------|---------|-------------| | directory | - | Path to media files (required) | | duration_minutes | 15 | Max minutes between files in a group | | distance_meters | 100 | Max distance between files in a group |

Output

Files will be renamed in the format:

Location1_001.jpg
Location1_002.mp4
Location2_001.png

Notes

• Files without valid timestamps will be ignored
• Requires ExifTool installed on system
• Always backup files before processing

License

MIT © Harshul Kansal

Support

If you find this project helpful, consider supporting my work:

• ☕ Buy Me a Coffee
• 💖 GitHub Sponsors
• 💰 PayPal