Plugin Settings

Free version uses Groq

The free version of Viscribe works exclusively with Groq's API and Llama 4 vision models. You will not find OpenAI, Anthropic, or Gemini here — those are available in the Pro add-on.

Configure Viscribe to perfectly match your site's needs. You can find all options under Settings → Viscribe (or Media → Viscribe) in your WordPress admin dashboard.

API Configuration

Enable Auto-Rename

This is the main toggle for Viscribe. When active, it will automatically process and rename every image you upload. If disabled, WordPress handles uploads normally.

• Default: Off

Groq API Key (Free Version)

Your API key connects Viscribe to Groq. The Pro version adds support for additional providers like OpenAI, Anthropic, and Google Gemini.

• Security: Keys are encrypted at rest using defuse/php-encryption.
• Get a Key: Generate one for free at console.groq.com.

Enhanced Security (Recommended)

For the highest level of protection, you can define your API key in wp-config.php. This bypasses the database entirely:

define('VISCRIBE_API_KEY', 'gsk_your_api_key_here');

When this constant is present, the plugin will prioritize it and ignore any key saved in the admin settings.

Protect Your Encryption Key

By default, Viscribe generates an encryption key stored in the database. To harden your site, define a custom encryption key in wp-config.php:

define('VISCRIBE_ENCRYPTION_KEY', 'your-long-random-string-here');

AI Model Selection

These models are available through Groq (free version). The Pro version adds OpenAI, Anthropic, and Google Gemini.

Model	Best For	Speed
Llama 4 Scout Recommended	High-speed processing with great accuracy.	~750 tokens/s
Llama 4 Maverick Deprecated	More detailed analysis, but deprecated by Groq.	~600 tokens/s

Llama 4 Scout is the recommended default for most users.

Use as Alt Text

When enabled, Viscribe also populates the image's alt attribute with the AI-generated description, which helps with accessibility and SEO.

• Note: Enabling this will automatically increase the keyword limit to ensure the alt text is sufficiently descriptive.
• Default: Off

Image Formats

Select which file types Viscribe should handle. You can toggle support for individual formats based on your workflow.

Format	Recommended
JPEG/JPG	✅ Yes
PNG	✅ Yes
WebP	✅ Yes
GIF	✅ Yes (Disabled by default)

Optimization Settings

Max Keywords

This setting determines the length and detail of your generated filenames. A higher number of keywords leads to more descriptive (but longer) file paths.

• Range: 1–10 keywords.
• Optimal: 3–5 keywords is typically best for SEO without creating overly long URLs.

For Developers

Viscribe stores its configuration in the WordPress options table under the key viscribe_options. You can retrieve these settings programmatically:

// Retrieve Viscribe settings
$options = get_option( 'viscribe_options', [] );

// Example: Check if renaming is enabled
if ( ! empty( $options['enabled'] ) ) {
    // Logic here
}

See also: Security & Privacy for details on encryption and data handling.