Description from extension meta
Automatically generates descriptive filenames for downloaded images using AI.
Image from store
Description from store
AI Filename Generator Chrome Extension
A Chrome extension that uses AI (LLaVa) to generate descriptive filenames for images when downloading them. The extension analyzes image content and suggests meaningful filenames based on what it sees.
Features
Right-Click Menu Integration
Quick save with AI-generated filename
Option to preview and customize filename before saving
Smart Filename Generation
Analyzes image content using AI
Creates concise yet descriptive filenames
Supports customizable filename formats
Local Processing with Ollama
Uses Ollama for local image analysis
Fast and private - no data sent to external servers
Requires Ollama with LLaVa model installed
User-Friendly Interface
Image preview
Filename customization
Format templates
Progress indicators
Error handling
Setup
Install and Configure Ollama
Install Ollama for your operating system
Pull the LLaVa model:
ollama pull llava
Start Ollama:
On macOS/Linux: Ollama runs automatically after installation
On Windows: Start Ollama from the Start Menu or run ollama serve in a terminal
Verify Ollama is running by opening
http://localhost:11434 in your browser
Usage
Quick Save
Right-click on any image
Select "Save with AI-generated filename"
The image will be saved automatically with an AI-generated filename
Preview & Customize
Right-click on any image
Select "Generate filename (with preview)"
Click the extension icon in the toolbar
Preview the suggested filename
Edit if desired
Click "Save Download"
Customize Settings
Click the extension icon
Access the Settings panel
Configure:
Filename format template
Preview preferences
Check Ollama status
Filename Format Templates
Use these placeholders in your format:
{object} - Main subject (required)
{location} - Location context
{date} - Current date
Example: {object}-{location}-{date}.jpg
Permissions
The extension requires these permissions:
contextMenus: For right-click menu integration
downloads: To save images
storage: To store settings
notifications: For status updates
<all_urls>: To access image URLs for processing
Error Handling
The extension includes robust error handling for:
Network issues
API failures
Timeout conditions
Invalid responses
Missing dependencies
Development
Project Structure
chrome-ai-filename-generator/
├── manifest.json # Extension configuration
├── background.js # Background script for context menu
├── content.js # Content script (if needed)
├── popup/ # Extension popup UI
│ ├── popup.html
│ ├── popup.js
│ ├── popup.css
├── api/ # API integration
│ ├── analyze.js
│ ├── llava_integration.js
├── icons/ # Extension icons
└── README.md
Building
No build step required. The extension uses native ES modules.
Common Issues
"Cannot connect to Ollama"
Ensure Ollama is running
Try visiting http://localhost:11434 in your browser
Restart Ollama if needed
"LLaVa model not found"
Run ollama pull llava to install the model
Check installed models with ollama list
"Failed to generate filename"
Check if Ollama is running
Verify the image URL is accessible
Try reloading the extension
Extension not working
Reload the extension in chrome://extensions
Restart Chrome
Ensure Ollama is running