Skip to content

Releases: mixaoc/PrivacyX

- PrivacyX - Firefox 4.7 (last version)

11 Feb 01:22
cfbf313

Choose a tag to compare

Firefox Extension Developer Mode Installation Guide

Overview

This guide will help you install your Firefox extension from source files using Developer Mode. Follow these steps sequentially for a successful installation.

Prerequisites Checklist

  • Mozilla Firefox installed (latest version recommended)
  • Extension source files organized in a folder
  • manifest.json file present in your extension folder
  • Know the location of your extension folder on your computer

Step-by-Step Installation

Step 1: Open Firefox Debugging Page

  1. Launch Firefox browser
  2. In the address bar, type exactly: about:debugging
  3. Press Enter to navigate

Step 2: Access Temporary Extensions Section

  1. On the left sidebar, click on "This Firefox" (if not already selected)
  2. In the main panel, find and click on "Extensions" section
  3. Look for the button labeled "Load Temporary Add-on..." and click it

Step 3: Load Your Extension Files

  1. A file dialog window will appear
  2. Navigate to your extension's source folder
  3. Select the manifest.json file from your extension folder
  4. Click "Open" to load your extension

Step 4: Verify Successful Installation

After loading, check for these indicators:

  • Your extension appears in the extensions list
  • Extension name matches your manifest.json
  • "Remove" button appears next to your extension
  • Extension ID is displayed
  • No error messages are shown

Testing Your Extension

  1. Check the browser toolbar for your extension icon
  2. Test basic functionality of your extension
  3. Open browser console (F12) to check for errors
  4. Verify permissions are working as expected

Development Notes

  • Temporary Nature: This installation is temporary and will be removed when Firefox closes
  • Automatic Reloading: Changes to your source files require reloading the extension
  • Debugging: Use browser developer tools (F12) for debugging your extension
  • Console Logs: Check both browser console and extension background page console

Common Issues and Solutions

Issue: "Invalid manifest" error

Solution: Verify your manifest.json is valid JSON and follows Firefox extension requirements

Issue: Extension doesn't appear in toolbar

Solution: Check if your manifest includes browser_action or page_action

Issue: Permission errors

Solution: Ensure all required permissions are declared in manifest.json

Issue: Extension disappears after restart

Note: This is normal for temporary add-ons. Use "Load Temporary Add-on" again after restart.

Next Steps for Development

  1. Make changes to your source files
  2. Reload extension by clicking "Reload" button in about:debugging
  3. Test changes immediately
  4. Repeat development cycle as needed

Important Reminders

  • Keep Firefox open to maintain your temporary extension
  • Save your source files frequently
  • Use version control for your extension code
  • Test on different Firefox versions if needed

Support

For Firefox extension development questions:

  • MDN Web Docs: Extension Development Guide
  • Firefox Add-ons Community Forum
  • Browser extension documentation

Note: This installation method is for development purposes only. For distribution, package your extension and submit to Firefox Add-ons marketplace.