AI Filename Generator

About

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