Files
2025-10-16 11:58:46 +01:00

95 lines
3.0 KiB
Plaintext

Greasemonkey Browser Extension
Author: Andy Dixon
Version: 1.0.0
=== FILE STRUCTURE ===
greasemonkey/
├── chrome/ Chrome Extension (Manifest V3)
│ ├── manifest.json Extension configuration
│ ├── background.js Background service worker
│ ├── content.js Content script (runs on pages)
│ ├── popup.html Extension popup UI
│ ├── popup.css Popup styling (Bootstrap Dark)
│ ├── popup.js Popup functionality
│ ├── icon16.png 16x16 icon
│ ├── icon48.png 48x48 icon
│ └── icon128.png 128x128 icon
│
├── firefox/ Firefox Extension (Manifest V2)
│ ├── manifest.json Extension configuration
│ ├── background.js Background script
│ ├── content.js Content script (runs on pages)
│ ├── popup.html Extension popup UI
│ ├── popup.css Popup styling (Bootstrap Dark)
│ ├── popup.js Popup functionality
│ ├── icon16.png 16x16 icon
│ ├── icon48.png 48x48 icon
│ └── icon128.png 128x128 icon
│
├── README.md Full documentation
├── BUILD.md Build and distribution instructions
├── QUICKSTART.md Quick start guide
├── test-page.html Test page for trying rules
└── MANIFEST.txt This file
=== FEATURES ===
✓ Execute custom JavaScript on any webpage
✓ Inject custom CSS styles on any webpage
✓ Three matching modes:
- URL contains string
- Page contains element (CSS selector)
- Both URL and element match
✓ Bootstrap 5 Dark theme UI
✓ Add, edit, delete, and toggle rules
✓ Persistent storage (synced across browser)
✓ Multiple rules support
✓ Visual rule indicators (type badges, JS/CSS badges)
✓ Chrome and Firefox compatible
=== QUICK INSTALL ===
Chrome:
1. chrome://extensions/
2. Enable "Developer mode"
3. Click "Load unpacked"
4. Select the chrome/ folder
Firefox:
1. about:debugging#/runtime/this-firefox
2. Click "Load Temporary Add-on"
3. Select firefox/manifest.json
=== USAGE ===
1. Click Greasemonkey icon in toolbar
2. Click "+ Add Rule"
3. Configure:
- Name your rule
- Choose match type
- Enter URL pattern and/or element selector
- Add JavaScript and/or CSS code
4. Save and reload target page
=== DOCUMENTATION ===
- README.md - Complete feature documentation and examples
- BUILD.md - Building and distribution instructions
- QUICKSTART.md - 5-minute getting started guide
- test-page.html - Interactive test page
=== NEXT STEPS ===
1. Read QUICKSTART.md to get started
2. Try the test-page.html for examples
3. Create your first rule
4. Read README.md for advanced features
5. See BUILD.md for distribution
=== SUPPORT ===
For questions or issues, contact Andy Dixon.
Enjoy! 🐒✨