Introduction
Welcome to WooTUI - a powerful terminal user interface for translating WooCommerce products using AI.
What is WooTUI?
WooTUI is a command-line application that automates the translation of WooCommerce product catalogs into multiple languages using Google's Gemini AI. It integrates seamlessly with the WordPress Multilingual Plugin (WPML) to provide a complete translation workflow.
Why WooTUI?
Speed & Efficiency
- Translate entire product catalogs in minutes, not hours
- Batch processing for handling large inventories
- Cost-effective AI translations with transparent pricing
Accuracy & Quality
- Context-aware translations using Google Gemini
- Preserves HTML formatting and special characters
- Maintains brand consistency across languages
Control & Flexibility
- Choose which columns to translate (descriptions, attributes, SEO meta)
- Override or skip existing translations
- Preview costs before executing translations
Terminal-First Design
- Fast, keyboard-driven interface
- Works on macOS, Windows, and Linux
- No browser required—runs entirely in your terminal
Key Features
🤖 AI-Powered Translation - Uses Google Gemini for accurate, context-aware translations
🌍 Multi-Language Support - Translate to any target language supported by Gemini
💰 Cost Transparency - See token usage and pricing estimates before translating
📦 WooCommerce CSV Compatible - Works directly with WooCommerce product exports
✅ Column Selection - Choose which columns to translate for maximum control
⌨️ Terminal UI - Fast, efficient interface built with OpenTUI
How It Works
WooTUI guides you through a simple 6-step wizard:
- CSV Path - Select your WooCommerce export file
- Column Selection - Choose which fields to translate
- Target Languages - Select languages and override settings
- Cost Estimation - Preview token usage and costs
- Translation - Execute translations via Gemini API
- Results - View summary and download translated CSV
The translated CSV file is ready to import back into WooCommerce with WPML, preserving all translation groups and metadata.
Use Cases
E-commerce Store Owners
- Expand to international markets quickly
- Maintain consistent product information across languages
- Update translated catalogs when products change
Agencies & Developers
- Batch translate multiple client stores
- Optimize translation costs with selective column translation
- Integrate into automated deployment workflows
Multilingual Marketplaces
- Scale product listings to multiple regions
- Ensure SEO optimization in every language
- Maintain translation quality without manual work
Quick Start
Ready to translate your first product? Head over to Installation to get started!
Need Help?
- Getting Started: New to WooTUI? Check out our Getting Started Guide
- Workflows: Learn common translation patterns in Workflows
- Troubleshooting: Run into issues? See Troubleshooting
- GitHub: Report bugs or request features at github.com/kkris0/wootui
What's Next?
- Install WooTUI on your system
- Translate your first product in 5 minutes
- Learn the interface for efficient navigation
- Configure settings to customize your workflow