Install Stylus from GitHub

This article describes installation of Stylus for testing. See releases on the main page for permanent installation.

Contents:

• Download and Extract the Extension.
• Install in Chrome.
• Install in Firefox.
  • Temporary installation.
  • Semi-permanent installation.

To test an unreleased update to our extension, you'll need to take a few extra steps to load it into the browser:

Download and Extract the Extension

• Select the branch (1-2); make sure the clicked button (1) shows "Branch:" followed by the branch name to test.

  

• Click the "Clone or download" button (1) and then click "Download ZIP" (2).

  

• Extract the ZIP folder in an easy to find location, like the desktop.

  • Extracting a ZIP file is built-in to newer versions of Windows & Mac OS.
  • For older versions, search Google for "unzip" . And install the necessary software.

Install in Chrome

• Open the following URL: chrome://extensions/.

• Check the "Developer mode" checkbox at the top (1).

• Click "Load unpacked extension..." (2).

  

• Select the extracted "stylus" folder (3) and click "OK" (4).

  

• Don't forget to disable any other versions of Stylus that are already installed!

Install in Firefox

Temporary Firefox installation

• Open the following URL: about:debugging#addons

• Click the "Load Temporary Add-on" button (1).

• Select the extracted "stylus" folder (2).

• Select any file within the folder (3). Any file will work.

• Click "Open" (4).

  

• Don't forget to disable any other versions of Stylus that are already installed!

• Also see Mozilla's video .

Semi-permanent Firefox installation

To install Stylus in Firefox without needing to follow the above steps every time you load Firefox:

• First, you'll need to have the Firefox Developer Edition installed.

• Open the manifest.json file from the extracted "stylus" folder in an editor.

• Delete the last two closing curly brackets "}" and add the following (we're adding Stylus' ID from the Mozilla addons site):

    },
    "applications": {
      "gecko": {
        "id": "{7a7a4a92-a2a0-41d1-9fd7-1e92480d612d}"
      }
    }
  }

• Now zip all of the contents of the stylus folder.

• Go to the Firefox about:addons page.

• Click the gear icon and choose "Install Add-on From File..."

  

• Select the zipped stylus folder & click the "Open" button.

• If you get a message saying that the add-on could not be installed because it's not verified, then check to make sure you're using the Firefox developer edition; otherwise, you might be out of luck.