Viscribe

Viscribe is a WordPress plugin that automatically renames your uploaded images using AI. When you upload a picture to the Media Library, Viscribe sends it to Groq's Vision API (this is the free version — Groq is the only AI provider the free plugin connects to), which analyzes the content and suggests a descriptive, SEO-friendly filename. Instead of IMG_1234.jpg, you get golden-retriever-playing-fetch-park.jpg -- without any extra work.

The plugin can also populate the image's alt text with the same AI description, which improves accessibility for screen readers and gives your SEO an additional boost.

Viscribe is professionally built, tested, and maintained — not vibe-coded.

Key Features

• AI-Powered Renaming: The free version exclusively uses Groq's Llama 4 vision models (Scout by default; Maverick is also available but deprecated). Not OpenAI, not Anthropic, not Gemini — just Groq. The Pro add-on adds those.
• SEO-Friendly Slugs: Produces clean, lowercase, hyphenated filenames that search engines prefer.
• Secure API Key Storage: Keys are encrypted at rest using defuse/php-encryption. You can also store the key in wp-config.php to keep it out of the database entirely.
• Automatic Alt Text: Optionally saves the AI description as the image's alt attribute for better accessibility.
• Configurable Settings: Choose which image types to process, how many keywords to generate, and which AI model to use.
• Graceful Fallback: If the API is unreachable, the original filename is preserved. Uploads never fail because of the plugin.
• Free to Use: Works with Groq's free API tier -- no credit card required.

How It Works

When you upload an image, Viscribe hooks into WordPress's wp_handle_upload_prefilter. The image is sent to the AI provider (Groq in the free version), which returns descriptive keywords. These are sanitized into a clean slug and applied as the new filename before the file is saved. If alt text is enabled, the description is stored temporarily and applied once the attachment is created.

For a full walkthrough of every step, see How It Works.

Before vs. After

Original Filename	Renamed by Viscribe
IMG_1234.jpg	golden-retriever-playing-fetch-sunny-park.jpg
photo_2026.png	modern-office-desk-laptop-coffee.png
screenshot.webp	wordpress-dashboard-settings-page.webp

Supported Formats

JPEG, PNG, WebP, and GIF. You can enable or disable individual formats in the settings.

See the Before & After gallery for more real-world examples.

Requirements

• WordPress 6.0+
• PHP 8.2+
• A free Groq API key from console.groq.com (free version)

Resources

• GitHub Repository
• GitLab Repository
• WordPress.org Plugin Page
• Official Documentation

License

Viscribe is open-source software released under the GPL-2.0-or-later license.