Confetti (Alt+Z) sɣur S.M. Obaydur Rahman

🎉 Confetti Extension for Firefox/Zen Browser

A simple Firefox extension that triggers a beautiful confetti animation when you press Alt+Z.

🚀 Installation

Method 1: Load as Temporary Extension (Easiest - No XPI needed)

1. Open Zen Browser or Firefox
2. Type about:debugging in the address bar and press Enter
3. Click "This Firefox" (or "This Zen Browser")
4. Click "Load Temporary Add-on..."
5. Navigate to the confetti-extension folder
6. Select the manifest.json file
7. Done! ✅

Method 2: Install from XPI file

First, create the XPI file:

Option A: Using Python (Recommended)

cd /Users/shimantorehman/Downloads/confetti-extension
python3 build-xpi.py


Option B: Using Terminal

cd /Users/shimantorehman/Downloads/confetti-extension
chmod +x build-xpi.sh
./build-xpi.sh


Option C: Manually create XPI

1. Select these files:
   manifest.json
   content.js
   canvas-confetti.min.js
   icon.png
2. Right-click → Compress (creates a .zip file)
3. Rename the .zip file to .xpi

Then install the XPI:

1. Open Zen Browser
2. Go to about:addons
3. Click the gear icon ⚙️ (top right)
4. Select "Install Add-on From File..."
5. Choose confetti-extension.xpi
6. Confirm installation

⚠️ Note: In Zen/Firefox, unsigned XPI files still install as temporary extensions!

Method 3: Permanent Installation (Requires Signing)

For permanent installation, the extension needs to be signed by Mozilla:

1. Create the XPI file (see Method 2)
2. Go to Firefox Add-ons Developer Hub
3. Create an account and submit the XPI file
4. Wait for Mozilla approval
5. Install from the Firefox Add-ons store

🎊 Usage

1. Go to any website
2. Press Alt+Z (or Option+Z on Mac)
3. Enjoy the confetti! 🎉

✨ Features

Works on all websites
Beautiful multi-directional confetti animation
Lightweight and fast
No tracking, no ads, no data collection
Uses the popular canvas-confetti library

🔧 Customization

Want to change the keyboard shortcut or confetti settings?

1. Edit content.js:
   
   Change event.altKey && event.key === 'z' to use a different key
   Modify particleCount, spread, colors, etc. in the triggerConfetti() function
   2. Reload the extension:
   
   Go to about:debugging
   Click "Reload" next to the extension

📝 Files Included

manifest.json - Extension configuration
content.js - Main extension logic (listens for Alt+Z)
canvas-confetti.min.js - Confetti animation library
README.md - This file

⚠️ Note

As a temporary extension, it will be removed when you close the browser. You'll need to reload it each time you open Zen Browser, unless you:

1. Sign and publish it on Firefox Add-ons (permanent)
2. Use Firefox Developer Edition or Nightly with disabled signature checks

🐛 Troubleshooting

Confetti doesn't trigger:

Check the browser console (F12) for errors
Make sure you pressed Alt+Z (not Cmd or Ctrl)
Reload the extension from about:debugging

Extension disappears after restart:

This is normal for temporary extensions
Reload it from about:debugging → Load Temporary Add-on

📜 License

Free to use and modify!

Enjoy your confetti! 🎊