Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitLab with WP-CLI:
wp plugin install https://gitlab.com/thaikolja/viscribe-wordpress-plugin/-/archive/main/viscribe-wordpress-plugin-main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Viscribe – WordPress Plugin
Viscribe is a WordPress plugin that leverages Groq's free Vision API to analyze newly uploaded images, extracting descriptive keywords and automatically renaming the files. It can also optionally generate alt text for accessibility.
Example:
DSC3246.jpg → man-with-beard-in-car.jpg
Read the plugin's comprehensive documentation for more thorough guides, examples, and references.
For WordPress Users
See readme.txt or the WordPress.org plugin page for installation instructions. To see how far you can go with Viscribe, check out the official documentation.
For Developers
Requirements
- WordPress 6.0+
- PHP 8.2+
- Node.js 20+ and npm/bun
- Composer 2.x
- A free Groq API key
Setup
Architecture
- PSR-4 autoloading: Viscribe\ → includes/
- Twig 3.24+ for admin templates with custom {% trans %} tag compiled to () at compile time
- Hook-driven upload pipeline: wphandleuploadprefilter → ImageUploader → GroqService → FileSanitizer
Extension Hooks
The plugin fires actions and filters for Pro add-on integration:
| Hook | Type | Purpose |
|------|------|---------|
| viscribeservicesloaded | action | After core services init |
| viscribeloaded | action