A Firefox extension that reads web pages and gets an AI to write notes for you with one keyboard shortcut. Read first, press the key, get organized notes.
- One hotkey and you're done: Press
Alt+Shift+Nand let the robot do the work - Groq API with Llama 3.3 70B: Pretty fast, pretty smart, pretty free
- 25+ languages: English, Spanish, French, German, Nordic stuff, and more
- Creates folders in Downloads: Tell it a folder name and it'll create it if it doesn't exist
- Markdown output: Clean formatting with metadata and all that
- Quick notification: Get a little popup when your notes are saved, then it's done
- Download the latest release: Go to Releases and download the
.xpifile - Open your browser and drag the
.xpifile into the window, OR:- Go to
about:addons - Click the gear icon → "Install Add-on From File"
- Select the downloaded
.xpifile
- Go to
- Configure your API key (see Configuration below)
The .xpi file is Mozilla-signed and works in Firefox and Firefox-based browsers like Zen.
If you want to hack on the code:
- Clone this repo
- Open Firefox and go to
about:debugging#/runtime/this-firefox - Click "Load Temporary Add-on"
- Pick the
manifest.jsonfile - Note: You'll need to reload it every time Firefox restarts
- Firefox 109.0 or later (also works with Firefox-based browsers like Zen)
- Free Groq API key from console.groq.com
- Go to
about:addons - Find "Rufuz the quick note guy" and click the gear icon
- Click "Preferences"
- Set up:
- Groq API Key: Get one free at Groq
- Output Language: Pick from 25+ languages
- Save Folder: Whatever folder name you want in Downloads (like "AI-Notes")
- Read a webpage
- Press
Alt+Shift+N - Wait a couple seconds
- Done. Notes saved to
Downloads/[your-folder]/notes-[page-title]-[timestamp].md
- Go to
about:addons - Click the gear icon
- "Manage Extension Shortcuts"
- Pick whatever key combo you want
- Grabs the text from whatever page you're on
- Sends it to Groq (Llama 3.3 70B model)
- AI writes notes with:
- Quick summary
- Key points
- Important stuff
- Action items
- Saves as markdown in your folder
- Manifest V2 - Firefox compatible
- Groq API - Llama 3.3 70B
- Native Firefox APIs - downloads, storage, notifications
- Vanilla JavaScript - no frameworks, no bloat
Rufuz/
├── manifest.json # Extension configuration
├── background.js # Background script handling AI and downloads
├── content.js # Content script for page text extraction
├── options.html # Settings page UI
├── options.js # Settings page logic
├── icon-48.png # Extension icon (48x48)
├── icon-96.png # Extension icon (96x96)
└── icon.svg # Source SVG icon
- API key stored locally in Firefox
- Page content only goes to Groq for processing
- Nothing sent to third parties
- All notes saved on your machine
- Grabbing text: ~10-50ms
- AI thinking: 2-5 seconds
- Total: Usually 2-6 seconds start to finish
Groq's free tier is pretty solid:
- 30 requests per minute
- Free for normal people
- Llama 3.3 70B is fast
Notes not saving:
- Did you save your settings after entering the folder name?
- Try reloading the extension in
about:debugging
API key error:
- Double-check your Groq API key
- Make sure you have credits at console.groq.com
Keyboard shortcut not working:
- Probably conflicts with another extension or browser shortcut
- Change it in Manage Extension Shortcuts
Want to build your own signed .xpi?
npm install -g web-ext- Go to https://addons.mozilla.org/developers/addon/api/key/
- Generate new credentials
- Copy your JWT issuer and secret
web-ext sign \
--api-key=YOUR_JWT_ISSUER \
--api-secret=YOUR_JWT_SECRET \
--channel=unlistedThe signed .xpi will be in web-ext-artifacts/
This repo has GitHub Actions set up to automatically sign and release the extension when you push a version tag
Found a bug or want to improve something? Open an issue or PR!
MIT
Built with ☕ Claude my guy
Icon inspired by Rufus from Kim Possible