Jane-xiaoer

Jane-xiaoer / smart-rename

Public

Right-click any file in Finder → AI gives it a meaningful name. Images, videos, PDFs, Word, Markdown, folders. macOS native, BYOK Gemini, MIT.

ai automation bash cli file-management
10
0
100% credibility
Found Apr 27, 2026 at 10 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Shell
AI Summary

A macOS Finder extension that lets users right-click files or folders to get AI-generated meaningful Chinese filenames based on content analysis.

How It Works

1
🔍 Discover Smart Rename

You find this handy macOS tool while searching for an easy way to give your messy files better, more descriptive names.

2
📥 Install in 30 seconds

Download the tool and run its simple setup script to add a right-click option in Finder.

3
🔗 Connect a free AI helper

Link a free AI service from Google so it can look inside your files and suggest smart names.

4
🖱️ Right-click magic

Select any images, videos, PDFs, docs, or folders in Finder, right-click into Quick Actions, and choose Smart Rename – it starts analyzing instantly.

5
👀 Preview new names

A box pops up showing old boring names next to exciting new ones like 'Kyoto Bamboo Forest Morning Light_2024-03-15.jpg'.

6
✅ Confirm and rename

Click confirm to apply the changes, or undo anytime if you change your mind.

🎉 Perfectly organized files

Your files now have meaningful Chinese names that make them easy to find and understand at a glance, saving you tons of time.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 10 to 10 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is smart-rename?

Smart Rename adds a right-click menu option in macOS Finder for AI-powered file renaming using Google Gemini. Select images, videos, PDFs, Word docs, Markdown, TXT, or folders, hit Quick Actions > "改名 (Smart Rename)", preview descriptive Chinese names (content first + date), and confirm—e.g., IMG_20240315.jpg becomes 京都岚山_竹林晨光_2024-03-15.jpg. Shell-based with Python analysis, it supports bulk ops, CLI commands (--preview, --apply, --undo), and optional Hammerspoon hotkey.

Why is it gaining traction?

Native macOS right-click integration skips browser extensions or apps, routing files to Gemini Vision for images/videos or text extraction for docs/folders. As a smart bulk renamer and right-click tool on GitHub, it processes 100 files in ~1 minute for $0.01 via free-tier keys, with previews and JSON logs for safety. Beats manual Finder renames or generic tools lacking content awareness.

Who should use this?

Mac designers dumping client photos/videos, devs archiving screenshot Markdown/PDF notes, or content creators sorting phone exports. Ideal for anyone right-clicking messy folders daily, like turning scan.pdf into 机器学习_监督学习_线性回归_2024-04-25.pdf.

Verdict

Worth installing on macOS Monterey+ for quick wins—excellent docs, BYOK setup, and clean uninstall despite 10 stars and 1.0% credibility score signaling early maturity. Skip if needing English names or non-Mac support yet.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.