1.0.7 • Published 5 months ago

content-renamer v1.0.7

Weekly downloads
-
License
MIT
Repository
github
Last release
5 months ago

Media Group Renamer 🖼️📹

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

Demo

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
  1. Group files with a 30-minute window and 200-meter distance:
content-renamer --directory ~/Videos --duration 30 --distance 200
  1. Use interactive mode:
content-renamer --interactive
  1. Organize files in a relative path:
content-renamer --directory ../Trip/Photos

Configuration

ParameterDefaultDescription
directory-Path to media files (required)
duration_minutes15Max minutes between files in a group
distance_meters100Max 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

1.0.7

5 months ago

1.0.6

5 months ago

1.0.5

5 months ago

1.0.4

5 months ago

1.0.3

5 months ago

1.0.2

5 months ago

1.0.1

5 months ago

1.0.0

5 months ago