Skip to content

vidalmaxime/make-grug-brained

Repository files navigation

Grug Brained Banner

For grugs:

what make grug brained do

take fancy complex page
make simple like grug brain
remove big word complexity
add grug wisdom

how work

you point at page
grug magic happen
page now speak grug

example transform

"utilizing sophisticated methodologies" become "use simple way"
"enterprise-grade solution" become "thing that work good"
"leveraging synergies" become "work together"

grug transformer features:

automatic big word detector
complexity remover
occasional grug grunt

why use:

brain hurt less
understand more
laugh sometimes

grug warn:

some page resist grug transform. bank page and government page have strong complexity demon. but grug transformer try anyway. install make grug brained, make whole internet speak like grug. world become simpler place. grug happy.

For big brains:

Chrome extension that transforms any webpage text into grug-brained style using the Gemini API.

Features

  • Transform entire webpages with one click
  • Convert complex text into simple grug-speak
  • Visual highlights show translated content
  • Toggle between original and translated text
  • Animated bat icon shows translation progress
  • Smart caching avoids repeated API calls
  • Rate limiting respects API usage limits

Installation

  1. Clone this repository or download the files
  2. Open Chrome and navigate to chrome://extensions/
  3. Enable Developer mode in the top right corner
  4. Click Load unpacked and select the project folder
  5. The extension icon will appear in your browser toolbar
  6. Click on it, get a Gemini API key from Google AI Studio through the link and you're all set

Setup

  1. Click the extension icon in your toolbar
  2. Enter your Gemini API key in the settings
  3. Click save to store your key
  4. The extension is now ready to use

How to Use

  1. Navigate to any webpage with text content
  2. Click the extension icon to open the popup
  3. Click "make page for grug" to translate the page
  4. Wait a few seconds to get the grug text
  5. Click "make page for big brain" to restore original text

Technical Details

The extension works by:

  • Scanning webpages for text content
  • Sending batches of text to the Gemini API
  • Prompting to generate grug-style translations
  • Replacing original text while preserving formatting
  • Adding visual indicators to show translated content
  • Caching results for faster repeat visits

File Structure

  • manifest.json - Extension configuration and permissions
  • background.js - Handles API communication with Gemini
  • content.js - Manages page text scanning and replacement
  • popup.html - Extension interface layout
  • popup.css - Interface styling and animations
  • popup.js - Interface logic and user interactions
  • images/ - Animation frames and icons

Privacy

Your API key is stored locally in your browser and never shared. Text content is only sent to Google's Gemini API for translation. No user data is tracked or stored by this extension.

Contributing

Contributions are welcome. This project uses standard web technologies and the Chrome Extensions Manifest V3 format.

License

MIT License - free to use and modify.

Credits

Thanks to Carson Gross (https://grugbrain.dev/) and Sam Rodriques (https://www.sam-rodriques.com/post/the-grugbrained-ceo) for the inspiration!

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published