📋 Table of Contents
Welcome to Formageddon! 👋
Formageddon is an AI-powered Chrome extension that automatically fills web forms with realistic, context-aware data using OpenAI's GPT models. This guide will help you get started in minutes!
✨ Perfect for:
- 🧑💻 Developers testing forms
- 🧪 QA engineers
- 📊 Demo data generation
- ⚡ Anyone filling repetitive forms
1 Installation
📥 From Chrome Web Store
- Visit the Chrome Web Store
- Search for "Formageddon"
- Click "Add to Chrome"
- Confirm by clicking "Add extension"
- You'll see the Formageddon icon in your toolbar 🎉
💡 First-Time Users: After installation, a welcome page will open automatically to guide you through the initial setup.
2 Initial Setup
🔑 Get Your OpenAI API Key
Formageddon uses OpenAI's API, so you'll need your own API key:
- Go to OpenAI API Keys
- Sign in or create an account
- Click "Create new secret key"
- Give it a name (e.g., "Formageddon")
- Copy the key (it starts with
sk-...)
⚠️ Important:
- Keep your API key secret - never share it publicly
- You'll be billed by OpenAI based on usage (typically pennies per form)
- Set up billing at OpenAI Billing
⚙️ Configure Formageddon
- Click the Formageddon icon in your toolbar
- Paste your OpenAI API key in the "API Key" field
- Click "Save Settings"
- Optionally, click "Test API Key" to verify it works
✅ You're all set! Your API key is stored securely in your browser (encrypted by Chrome).
3 Basic Usage
🎯 Two Ways to Autofill
Single Field
Fill one field at a time with precision
Whole Form
Fill entire forms in one click
Option 1: Single Field Autofill
- Navigate to any webpage with a form
- Right-click on any input field
- Select "AutoFill this field" from the context menu
- Wait a moment while AI generates appropriate content
- The field will be filled automatically! ✨
💡 Smart Context Detection: Formageddon analyzes the field label, placeholder, surrounding text, and even other filled fields to generate perfect content!
Option 2: Whole Form Autofill
- Navigate to any webpage with a form
- Right-click anywhere on the page (not on a specific field)
- Select "Fill entire form" from the context menu
- Watch as all form fields are filled intelligently! 🎉
✨ Pro Tip: Whole form autofill is more efficient (1 API call) and maintains better context between fields!
🔄 What Gets Filled?
Formageddon intelligently fills:
- ✅ Text inputs (names, emails, addresses, etc.)
- ✅ Text areas (comments, descriptions, messages)
- ✅ Number inputs (phone, age, quantity)
- ✅ Email inputs (realistic email addresses)
- ✅ URL inputs (valid website addresses)
- ✅ Date inputs (appropriate dates)
- ✅ Select dropdowns (picks appropriate option)
- ✅ Radio buttons (selects best option)
- ✅ Checkboxes (checks if required)
4 Advanced Features
🎛️ Model Selection
Choose the AI model that fits your needs:
- GPT-4o - Fastest, most efficient (recommended for most users)
- GPT-4o-mini - Even faster and cheaper
- GPT-4 Turbo - Most capable, slightly slower
- GPT-3.5 Turbo - Budget option, still very good
💡 Recommendation: Start with GPT-4o-mini - it's fast, cheap, and works great for most forms!
🌡️ Temperature Control
Adjust creativity of generated content:
- 0.0 - 0.3 - Deterministic, consistent results
- 0.4 - 0.7 - Balanced (default: 0.7)
- 0.8 - 1.0 - Creative, varied results
📏 Max Tokens
Control response length (default: 150 tokens ≈ 100 words):
- 50-100 - Short fields (names, emails)
- 100-200 - Medium fields (addresses, descriptions)
- 200-500 - Long text areas (comments, essays)
🔄 Ignore Existing Input
Two modes:
- Unchecked (default): Preserves existing field values, only fills empty fields
- Checked: Overwrites all fields with fresh data
⚡ Rate Limiting
Built-in Protection: Formageddon limits you to 20 requests per minute to prevent accidental API abuse and protect your wallet!
5 Troubleshooting
❌ Common Issues & Solutions
Problem: "Invalid API Key" error
Solutions:
- Make sure your API key starts with
sk- - Verify you copied the entire key (no spaces)
- Check if your OpenAI account has billing enabled
- Try generating a new API key
Problem: "Rate limit exceeded"
Solutions:
- Wait 1 minute before trying again
- You've hit the 20 requests/minute limit
- This is a safety feature to protect your API costs
Problem: "Request timeout"
Solutions:
- Check your internet connection
- OpenAI API might be slow or down - try again in a moment
- Try a faster model (GPT-4o-mini)
Problem: Fields not filling correctly
Solutions:
- Try increasing Max Tokens in settings
- Check if the field type is supported
- Some fields might have JavaScript validation - fill manually if needed
- Refresh the page and try again
Problem: Context menu not appearing
Solutions:
- Reload the page (Ctrl/Cmd + R)
- Check if extension is enabled in chrome://extensions/
- Try reinstalling the extension
6 Frequently Asked Questions
💰 How much does it cost?
The extension is FREE, but you pay OpenAI for API usage:
- GPT-4o-mini: ~$0.001 per form (very cheap!)
- GPT-4o: ~$0.01 per form
- GPT-4: ~$0.03 per form
Most users spend less than $1/month!
🔒 Is my data safe?
Yes!
- ✅ Your API key is stored locally (encrypted)
- ✅ We don't collect or store any data
- ✅ Form data goes directly from your browser to OpenAI
- ✅ No tracking, no analytics, no ads
Read our Privacy Policy for details.
🌍 What about GDPR?
We're GDPR compliant:
- No personal data collection by us
- OpenAI is GDPR compliant
- You control all your data
- Delete anytime by uninstalling
📱 Does it work on mobile?
No, Formageddon is a Chrome Extension for desktop browsers only. It works on:
- ✅ Chrome (Windows, Mac, Linux)
- ✅ Chromium-based browsers (Edge, Brave, Opera)
- ❌ Mobile browsers (not supported)
🔄 Can I use it offline?
No, Formageddon requires an internet connection to communicate with OpenAI's API.
🎨 Can I customize the generated content?
Yes! Adjust these settings in the popup:
- Model selection (affects quality and style)
- Temperature (affects creativity)
- Max tokens (affects length)
🐛 I found a bug! How do I report it?
We appreciate bug reports! Please:
- 📧 Email: info@metinet.de
- 🐛 GitHub Issues: Report an Issue
💡 Can I request features?
Absolutely! We love feature requests:
- Open an issue on GitHub
- Email us at info@metinet.de
🔓 Is it open source?
The code is available on request. Contact us at info@metinet.de if you're interested in contributing!
💡 Tips & Tricks
🚀 Power User Tips:
- Use Whole Form Autofill - It's faster and cheaper (1 API call instead of many)
- Start with GPT-4o-mini - Great quality, very cheap
- Lower temperature for forms - Use 0.5-0.7 for consistent, realistic data
- Check required fields - Formageddon always fills required fields first
- Review before submitting - Always check generated data before submitting forms
- Set billing limits - Set a monthly limit in your OpenAI account to control costs
⚠️ Best Practices:
- Don't use for production/real submissions (test data only!)
- Review generated content before submitting
- Keep your API key secret
- Monitor your OpenAI usage/costs
- Use the extension responsibly
🆘 Need More Help?
We're here to help!
- 📧 Email: info@metinet.de
- 🐛 Bug Reports: GitHub Issues
- 🔒 Privacy: Privacy Policy
- 💬 General Questions: info@metinet.de
Response Time: We typically respond within 1-2 business days.
✅ Quick Start Checklist
Ready to go? Make sure you've completed:
- ☑️ Installed Formageddon from Chrome Web Store
- ☑️ Created OpenAI account and got API key
- ☑️ Set up billing in OpenAI account
- ☑️ Saved API key in Formageddon popup
- ☑️ Tested with "Test API Key" button
- ☑️ Tried autofilling a form field
- ☑️ Read the Privacy Policy
✨ You're all set! Happy autofilling!