AI Media Renamer (WP)

AI Media Renamer is a powerful WordPress plugin that leverages Google's Gemini AI to automatically rename your media files based on their content. It helps improve SEO, accessibility, and library organization by replacing generic filenames (like IMG_1234.jpg) with descriptive, keyword-rich filenames.

🚀 Features

• AI-Powered Image Analysis: Uses Google Gemini (default: Gemini 2.5 Flash) to "see" your images and generate accurate captions.
• SEO-Friendly Filenames: Automatically converts captions into clean, hyphenated slugs.
• Bulk Processing: Process dozens of images at once with a stable, batch-based workflow.
• Auto-Rename Mode: One-click analysis and renaming for your entire library.
• Smart Filtering: Easily find "Generic" filenames that need renaming.
• Undo Functionality: Revert any rename operation with a single click if you change your mind.
• Automatic Content Updates: Automatically replaces old URLs with new ones in your posts and pages.

🛠️ Installation

1. Download the repository as a ZIP file.
2. Go to your WordPress Admin dashboard.
3. Navigate to Plugins > Add New > Upload Plugin.
4. Choose the ZIP file and click Install Now.
5. Activate the plugin.

⚙️ Configuration

1. Go to Media > AI Renamer in your WordPress sidebar.
2. Click on the Settings tab.
3. Enter your Google Gemini API Key. You can get one for free at Google AI Studio.
4. Click 🔌 Test Connection to verify your key.
5. Save settings.

📖 How to Use

Individual Renaming

1. In the Dashboard tab, click 🔍 Analyse on any image.
2. Review the suggested name and caption.
3. Click ✅ Approve to rename the file.

Bulk Renaming

1. Select multiple images using the checkboxes.
2. Click 🔍 Bulk Analyse to generate suggestions for all selected images.
3. Once analysed, click ✅ Bulk Approve to rename them all at once.
4. Or use 🚀 Auto-Rename to do both steps automatically.

Filtering Generic Files

• Use the "Select Generic" button to automatically highlight files with names like IMG_..., DSC_..., etc.

🏗️ Project Structure

• ai-media-renamer.php: Main plugin entry point and initialization.
• admin/:
  • class-admin-page.php: Handles the admin menu, tabs, and AJAX endpoints.
  • assets/: CSS and JS for the admin interface.
  • views/: HTML templates for the dashboard and settings.
• includes/:
  • class-ai-connector.php: Handles API communication with Google Gemini.
  • class-media-scanner.php: Logic for scanning the media library and detecting generic names.
  • class-renamer.php: Core logic for physical file renaming and DB updates.

📝 License

This project is licensed under the GPL v2 or later.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request or open an issue for bugs and feature requests.

Built with ❤️ by Suryakanth using AI.