Smart Rename – renames image file downloads in real time using local AI
Smart Rename is an open‑source tool that uses a local AI model (llava) to monitor folders and automatically rename image files with descriptive names in real time. It runs completely offline, protecting privacy, and is controlled via a system tray icon.
Notifications You must be signed in to change notification settings
Fork 0
Star 0
BranchesTags
Open more actions menu
Folders and files
NameName
Last commit message
Last commit date
Latest commit
History
7 Commits
7 Commits
README.md
README.md
requirements.txt
requirements.txt
run.bat
run.bat
setup.bat
setup.bat
setup.sh
setup.sh
watcher.py
watcher.py
Repository files navigation
Automatically renames image files with descriptive names using local AI — fully private, no internet required, runs in your system tray. What makes this unique compared to other similar projects is the ability to rename images downloaded in realtime.
Before → After
screenshot_48392.png → boy_band_singer_posing.png IMG_20240531.jpg → red_race_car_on_track.jpg download (1).webp → golden_retriever_in_grass.webp
Requirements
You need to install these two things manually — everything else is handled by the setup script.
- Python 3.10+
Linux: use your package manager
sudo pacman -S python # Arch sudo apt install python3 # Ubuntu/Debian
Windows: download from python.org
⚠️ Check "Add Python to PATH" during installation.
- Ollama
Linux:
curl -fsSL https://ollama.com/install.sh | sh
Windows: download the installer from ollama.com
Installation
git clone https://github.com/chudweiser/smart-rename.git cd smart-rename
Linux:
bash setup.sh
Windows: double-click setup.bat (.exe available in releases for easy 1 click run, application is found as a green circle in your taskbar) Avoid OneDrive folders
The setup script will:
Check Python and Ollama are installed
Download the llava AI model (~4GB, one time only)
Create a virtual environment
Install all Python dependencies
Create a run.sh / run.bat shortcut to launch the app
Usage
Linux:
bash run.sh
Windows: double-click run.bat
A green dot appears in your system tray. Right-click it to open Settings, pause, or quit.
Drop any image into a watched folder and it gets renamed within a couple of seconds.
Default watched folders
On first run, Smart Rename watches whichever of these exist:
Linux Windows
~/Downloads C:\Users\YOU\Downloads
~/Pictures/Screenshots C:\Users\YOU\Pictures\Screenshots
~/Pictures C:\Users\YOU\Pictures
Add or remove folders anytime from the Settings window.
Supported formats
.jpg .jpeg .png .gif .bmp .webp .tiff
Troubleshooting
Nothing is renaming — make sure Ollama is running. The setup script starts it automatically via run.sh/run.bat, but if you launched watcher.py directly, start Ollama first with ollama serve.
Slow on first image — llava loads into GPU memory on first use (~1–2s extra). Every image after that is fast.
Tray icon missing on Linux — install the appindicator library:
sudo pacman -S libappindicator-gtk3 # Arch sudo apt install libappindicator3-1 # Ubuntu
About
Uses ollama/lava to rename image files in real-time
Resources
Readme
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
0 stars
Watchers
0 watching
Forks
0 forks
Report repository
Releases 1
Smart Rename v1.0.0
Latest
Jun 1, 2026
Packages 0
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Python 82.8%
Batchfile 8.9%
Shell 8.3%