Rename Images with AI - Raycast Extension

A Raycast extension that uses AI to intelligently rename screenshot and image files based on their content.

Features

• AI-Powered Naming: Uses Google Gemini to analyze your screenshots and create descriptive, meaningful filenames
• Batch Processing: Select multiple screenshots at once to rename them all in one go
• Finder Integration: Directly rename multiple files selected in Finder
• User-Friendly UI: Simple interface with clear feedback on the renaming process
• Adjustable Batch Size: Control how many files are processed simultaneously

Installation

1. Make sure you have Raycast installed
2. Clone this repository
3. Open the directory in your terminal
4. Run npm install to install dependencies
5. Run npm run dev to start the development server and install the extension in Raycast

Configuration

The extension requires a Google Gemini API key to analyze your screenshots:

1. Get a Google Gemini API key:

   • Go to Google AI Studio
   • Create an API key (free to start)
   • Copy your API key

2. Open Raycast and go to the extension settings for "Rename Tidy Titles"

   • Enter your Google Gemini API key

3. Optional: Adjust batch size to control how many files are processed at once

How It Works

The extension uses Google Gemini's vision capabilities to analyze the content of each screenshot and generate a descriptive filename. For example:

• A screenshot of a chart might be renamed to sales_chart.png
• A screenshot of a login page might be renamed to login_page_ui.png

This makes it much easier to search for specific screenshots later, as the filenames actually describe the content.

Gemini 1.5 Flash offers excellent image understanding at a low cost, and most new Google AI accounts start with a free quota.

Usage

Method 1: Interactive UI Method

1. Open Raycast and search for "Rename Screenshots"
2. Click "Select Screenshots" to choose the image files you want to rename
3. Click "Rename Screenshots" to start the AI analysis and renaming process
4. Review the results in the list view

Method 2: Instant Rename (Recommended)

1. Select screenshot files in Finder
2. Open Raycast and search for "rename" (or "Rename Selected Files")
3. Press Enter - files will be renamed instantly without additional steps
4. A toast notification will confirm when renaming is complete

The Instant Rename method is perfect for quickly renaming files with a single command while you continue working.

Examples

Before:

• Screenshot 2023-11-15 at 10.32.45.png
• Screenshot 2023-11-16 at 15.20.33.png

After:

• sales_dashboard_chart.png
• login_page_ui.png

Requirements

• Raycast v1.50.0 or higher
• Node.js v16 or higher
• Google Gemini API key (required)

Troubleshooting

API Key Issues

• Make sure you've created an API key in Google AI Studio and have accepted the terms of service
• Verify that you've entered the API key correctly in the extension preferences

Rate Limits & Quota Issues

If you encounter rate limit errors:

1. Check your Google AI Studio quota
2. Most new accounts start with a free quota that's generous for personal use
3. You may need to set up billing if you're processing large batches of images

General Troubleshooting

• Processing Large Batches: Try renaming in smaller batches by reducing the batch size in preferences
• File Permission Issues: Make sure Raycast has permission to access and modify the files
• File Selection Issues: If files aren't being detected, make sure you've selected them in Finder first

License

MIT