coffinxp · Tednoob17 · Oct 20, 2025
diff --git a/README-Firefox.md b/README-Firefox.md
@@ -0,0 +1,97 @@
+# Wayback URL Finder - Firefox Edition
+
+A Firefox extension that helps you quickly discover archived URLs from the Wayback Machine. Perfect for bug bounty hunters, security researchers, and OSINT enthusiasts.
+
+## Features
+
+- Instant URL Lookup – Quickly fetch archived URLs from the Wayback Machine.  
+- Four Search Modes:
+  1. Main Domain URLs (`https://example.com/*`)
+  2. Wildcard Domain URLs (`*.example.com/*`)
+  3. Specific Path URLs (`https://example.com/path/*`)
+  4. Sensitive File Extensions (`.pdf`, `.sql`, `.json`, `.env`, `.bak`, etc.)
+
+## Installation
+
+### Method 1: Developer Mode (Temporary)
+1. Download or clone this repository:
+   ```bash
+   git clone https://github.com/coffinxp/wayback-url-finder.git
+   ```
+
+2. Open Firefox and navigate to `about:debugging`
+
+3. Click "This Firefox" on the left sidebar
+
+4. Click "Load Temporary Add-on..."
+
+5. Navigate to the project folder and select the `manifest.json` file
+
+6. The Wayback URL Finder icon should now appear in your Firefox toolbar
+
+**Note**: Temporary add-ons are removed when Firefox restarts.
+
+### Method 2: Permanent Installation (Advanced)
+For permanent installation, you would need to:
+1. Package the extension as a `.xpi` file
+2. Sign it through Mozilla's Add-on Developer Hub
+3. Install the signed `.xpi` file
+
+## Usage
+
+1. Navigate to any webpage
+2. Click the Wayback URL Finder icon in your Firefox toolbar
+3. Choose one of the following options:
+   - Main Domain URLs
+   - Wildcard Domain URLs
+   - Specific Path URLs
+   - Sensitive File Extensions
+4. The extension will open the corresponding Wayback Machine results in a new tab
+
+## Key Differences from Chrome Version
+
+- Uses Manifest V2 (Firefox's current standard)
+- Uses `browser` API instead of `chrome` API
+- Uses `browser_action` instead of `action` in manifest
+- Includes additional `tabs` permission for Firefox compatibility
+
+## Example Queries
+
+### Main Domain
+```
+https://web.archive.org/cdx/search/cdx?url=example.com/*&collapse=urlkey&output=text&fl=original
+```
+
+### Wildcard Domain
+```
+https://web.archive.org/cdx/search/cdx?url=*.example.com/*&collapse=urlkey&output=text&fl=original
+```
+
+### Specific Path
+```
+https://web.archive.org/cdx/search/cdx?url=https://example.com/path/*&collapse=urlkey&output=text&fl=original
+```
+
+### Sensitive File Extensions
+```
+https://web.archive.org/cdx/search/cdx?url=*.example.com/*&collapse=urlkey&output=text&fl=original&filter=original:.*\.(xls|xml|xlsx|json|pdf|sql|doc|docx|pptx|txt|zip|tar\.gz|tgz|bak|7z|rar|log|cache|secret|db|backup|yml|gz|git|config|csv|yaml|md|md5|exe|dll|bin|ini|bat|sh|tar|deb|rpm|iso|img|apk|msi|env|dmg|tmp|crt|pem|key|pub|asc)$
+```
+
+## Troubleshooting
+
+- If the extension doesn't appear, make sure you selected the `manifest.json` file during installation
+- If buttons don't work, check the browser console (F12) for any JavaScript errors
+- Make sure Firefox allows the extension to access the current tab
+
+## Contributing
+
+Pull requests are welcome! Feel free to suggest new features, UI improvements, or bug fixes via GitHub issues.
+
+## Author
+
+**Coffinxp** - Bug bounty hunter & security researcher (Original Chrome version)
+Converted to Firefox by Assistant
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
diff --git a/README.md b/README.md
@@ -2,18 +2,24 @@
 
 # Wayback URL Finder
 
-A Chrome extension that helps you quickly discover archived URLs from the Wayback Machine. Perfect for bug bounty hunters, security researchers, and OSINT enthusiasts.
+A browser extension that helps you quickly discover archived URLs from the Wayback Machine. Perfect for bug bounty hunters, security researchers, and OSINT enthusiasts.
 
-## Features
+**Now supports both Chrome and Firefox!** 🎉
 
-- Instant URL Lookup – Quickly fetch archived URLs from the Wayback Machine.  
-- Four Search Modes:
-  1. Main Domain URLs (`https://example.com/*`)
-  2. Wildcard Domain URLs (`*.example.com/*`)
-  3. Specific Path URLs (`https://example.com/path/*`)
-  4. Sensitive File Extensions (`.pdf`, `.sql`, `.json`, `.env`, `.bak`, etc.)
+## ✨ Features
 
-## Installation
+- **Cross-Browser Support** – Works on both Chrome and Firefox
+- **Instant URL Lookup** – Quickly fetch archived URLs from the Wayback Machine  
+- **Smart URL Detection** – Automatically detects the current tab's URL
+- **Four Powerful Search Modes**:
+  1. **Main Domain URLs** (`https://example.com/*`) - Find all archived pages for a domain
+  2. **Wildcard Domain URLs** (`*.example.com/*`) - Include all subdomains
+  3. **Specific Path URLs** (`https://example.com/path/*`) - Target specific paths
+  4. **Sensitive File Extensions** - Hunt for `.pdf`, `.sql`, `.json`, `.env`, `.bak`, and 30+ other file types
+
+## 🚀 Installation
+
+### Chrome Installation
 
 1. Download or clone this repository:
    ```bash
@@ -28,18 +34,43 @@ A Chrome extension that helps you quickly discover archived URLs from the Waybac
 
 5. The Wayback URL Finder icon should now appear in your Chrome toolbar
 
-## Usage
+### Firefox Installation
+
+1. Download or clone this repository (same as above)
+
+2. Open Firefox and navigate to `about:debugging`
+
+3. Click "This Firefox" on the left sidebar
+
+4. Click "Load Temporary Add-on..."
+
+5. Navigate to the project folder and select the `manifest.json` file
+
+6. The Wayback URL Finder icon should now appear in your Firefox toolbar
+
+**Note**: Firefox temporary add-ons are removed when the browser restarts.
+
+## 📖 Usage
 
 1. Navigate to any webpage
-2. Click the Wayback URL Finder icon in your Chrome toolbar
-3. Choose one of the following options:
-   - Main Domain URLs
-   - Wildcard Domain URLs
-   - Specific Path URLs
-   - Sensitive File Extensions
-4. The extension will open the corresponding Wayback Machine results in a new tab
+2. Click the Wayback URL Finder icon in your browser toolbar
+3. The current page URL will be automatically detected and filled in
+4. Choose one of the four search modes:
+   - **Main Domain URLs** - Find all archived pages for the domain
+   - **Wildcard Domain URLs** - Include all subdomains in the search
+   - **Specific Path URLs** - Search for URLs under a specific path
+   - **Sensitive File Extensions** - Hunt for potentially interesting files
+5. The extension will open the corresponding Wayback Machine results in a new tab
+6. Browse through the archived URLs to find valuable information
+
+### 💡 Pro Tips
+- You can manually edit the URL in the input field before searching
+- The sensitive file extensions search looks for 30+ file types including:
+  `xls`, `xml`, `xlsx`, `json`, `pdf`, `sql`, `doc`, `env`, `bak`, `zip`, `tar.gz`, `config`, `yml`, `git`, `db`, `backup`, and many more!
 
-## Example Queries
+## 🔍 Example Queries
+
+The extension generates these types of Wayback Machine queries:
 
 ### Main Domain
 ```
@@ -61,18 +92,86 @@ https://web.archive.org/cdx/search/cdx?url=https://example.com/path/*&collapse=u
 https://web.archive.org/cdx/search/cdx?url=*.example.com/*&collapse=urlkey&output=text&fl=original&filter=original:.*\.(xls|xml|xlsx|json|pdf|sql|doc|docx|pptx|txt|zip|tar\.gz|tgz|bak|7z|rar|log|cache|secret|db|backup|yml|gz|git|config|csv|yaml|md|md5|exe|dll|bin|ini|bat|sh|tar|deb|rpm|iso|img|apk|msi|env|dmg|tmp|crt|pem|key|pub|asc)$
 ```
 
-## Screenshots
+## 🛠 Technical Details
+
+### Browser Compatibility
+- **Chrome**: Uses Manifest V3 with `chrome` API
+- **Firefox**: Uses Manifest V2 with `browser` API and Promises
+
+### Architecture
+- **Manifest**: Cross-browser compatible configuration
+- **Popup Interface**: Clean, modern UI with loading states and tooltips
+- **Background Logic**: Efficient URL parsing and Wayback Machine query generation
+- **Permissions**: Minimal required permissions (`activeTab`, `tabs`)
+
+### File Structure
+```
+wayback-url-finder/
+├── manifest.json       # Extension configuration
+├── popup.html         # Main UI interface
+├── popup.js           # Core functionality
+├── icon.png           # Extension icon
+├── images/            # UI assets
+│   └── cursor-blue.cur
+└── README.md          # This file
+```
+
+## 📸 Screenshots
 
 <img width="366" height="521" alt="Screenshot 2025-10-19 091726" src="https://github.com/user-attachments/assets/646fe87c-8693-44a5-8c75-8012b77e0ae0" />
 
+## 📝 Changelog
+
+### Version 1.1 (Latest)
+- ✨ **New**: Firefox support added
+- 🔄 Updated to cross-browser compatible architecture
+- 🐛 Fixed hardcoded Chrome extension URLs
+- 📝 Enhanced documentation and installation guides
+- 🎨 Improved UI consistency across browsers
+
+### Version 1.0
+- 🎆 Initial Chrome extension release
+- 🔍 Four search modes for Wayback Machine
+- 🎨 Modern, dark-themed UI
+- ⚡ Instant URL detection from active tab
+
+## 🤝 Contributing
 
-## Contributing
+Contributions are welcome! Here's how you can help:
 
-Pull requests are welcome! Feel free to suggest new features, UI improvements, or bug fixes via GitHub issues.
+1. **Fork** the repository
+2. **Create** a feature branch: `git checkout -b feature/amazing-feature`
+3. **Commit** your changes: `git commit -m 'Add amazing feature'`
+4. **Push** to the branch: `git push origin feature/amazing-feature`
+5. **Open** a Pull Request
 
-## Author
+### Ideas for Contributions
+- 📱 Mobile browser support (if feasible)
+- 🎨 Additional themes or UI improvements
+- 🔍 More search filters or options
+- 🌍 Internationalization (i18n) support
+- 📊 Analytics or usage statistics
 
-**Coffinxp** - Bug bounty hunter & security researcher
-## License
+## 📞 Support & Issues
+
+If you encounter any issues:
+1. Check the [Issues](https://github.com/coffinxp/wayback-url-finder/issues) page
+2. Create a new issue with detailed information
+3. Include your browser version and steps to reproduce
+
+## 👥 Author
+
+**Coffinxp** - Bug bounty hunter & security researcher  
+[🔗 GitHub](https://github.com/coffinxp) | [🎥 YouTube](https://www.youtube.com/@lostsecc)
+
+## 📜 License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+<div align="center">
+  <strong>Made with ❤️ for the cybersecurity community</strong>
+  <br>
+  <em>Happy hunting! 🔍🎯</em>
+</div>
diff --git a/manifest.json b/manifest.json
@@ -1,10 +1,10 @@
 {
-  "manifest_version": 3,
+  "manifest_version": 2,
   "name": "Wayback URLs Finder",
   "version": "1.0",
   "description": "Fetch archived URLs from the Wayback Machine using different match types.",
-  "permissions": ["activeTab"],
-  "action": {
+  "permissions": ["activeTab", "tabs"],
+  "browser_action": {
     "default_popup": "popup.html"
   },
   "icons": {

diff --git a/popup.html b/popup.html
@@ -435,7 +435,7 @@
 
   <div class="header">
     <div class="logo-container">
-      <img src="chrome-extension://fpnmgdkabkmnadcjpehmlllkndpkmiak/images/wayback-bordered.png" alt="Wayback URL Finder" class="logo">
+      <img src="icon.png" alt="Wayback URL Finder" class="logo">
     </div>
   </div>
 

diff --git a/popup.js b/popup.js
@@ -7,7 +7,7 @@ document.addEventListener("DOMContentLoaded", () => {
   const toast = document.getElementById("toast");
 
   // Set current tab URL by default
-  chrome.tabs.query({ active: true, currentWindow: true }, (tabs) => {
+  browser.tabs.query({ active: true, currentWindow: true }).then((tabs) => {
     const currentTab = tabs[0];
     if (currentTab && currentTab.url) {
       urlInput.value = currentTab.url;
@@ -75,7 +75,7 @@ document.addEventListener("DOMContentLoaded", () => {
 
       // Open the URL after a short delay to show loading state
       setTimeout(() => {
-        chrome.tabs.create({ url: finalURL });
+        browser.tabs.create({ url: finalURL });
         setButtonLoading(button, false);
         showToast("Opening Wayback Machine...");
       }, 500);