GitHub - chudweiser/smart-rename: Uses ollama/lava to rename image files in real-time · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
chudweiser
smart-rename
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>7 Commits<br>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
View all files
Repository files navigation
Smart Rename
Automatically renames image files with descriptive names using local AI — fully private, no internet required, runs in your system tray.<br>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<br>IMG_20240531.jpg → red_race_car_on_track.jpg<br>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.
1. Python 3.10+
Linux: use your package manager
sudo pacman -S python # Arch<br>sudo apt install python3 # Ubuntu/Debian
Windows: download from python.org
⚠️ Check "Add Python to PATH" during installation.
2. 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<br>cd smart-rename
Linux:
bash setup.sh
Windows: double-click setup.bat<br>(.exe available in releases for easy 1 click run, application is found as a green circle in your taskbar)<br>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<br>Windows
~/Downloads<br>C:\Users\YOU\Downloads
~/Pictures/Screenshots<br>C:\Users\YOU\Pictures\Screenshots
~/Pictures<br>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<br>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
stars
Watchers
watching
Forks
forks
Report repository
Releases
Smart Rename v1.0.0
Latest
Jun 1, 2026
Packages
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<br>82.8%
Batchfile<br>8.9%
Shell<br>8.3%
You can’t perform that action at this time.