rename

AI-powered image renamer using Google Gemini. Analyzes images and renames them with descriptive filenames — concurrently.

Install

go install github.com/muhammedsamal/rename@latest

Setup

Copy .env.example to .env and add your API key (get one here):

cp .env.example .env

Usage

rename

On first run you'll be guided through:

1. Folder selection — Finder picker opens, or type a path manually
2. Naming format — choose how filenames are generated
3. How many — rename all or a subset; already-renamed images are skipped

Naming Formats

Option	Example
Normal Case	Golden Retriever Park
Sentence case	Golden retriever park
all lower	golden retriever park
dash-case	golden-retriever-park
Custom	holiday_{name} → holiday-golden-retriever-park

Change format anytime: rename --format

Flags

Flag	Description
--path <folder>	Set/update the folder path
--format	Change the naming convention
--count <n>	Set default concurrency (default: 3)
--delete	Clear all saved state
--help	Show help

Supported Formats

.jpg .jpeg .png .webp