Skip to content

Install Stylus from GitHub

stonecrusher edited this page Apr 17, 2019 · 20 revisions

This article describes the installation of Stylus for testing purpose. See releases on the main page for permanent installation.
BACK UP YOUR STYLES before you begin or you may lose them.

Contents:

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" external link. 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).

    firefox developer tools

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

  • Also see Mozilla's video external link.

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 external link 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..."

    install addon 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.

Clone this wiki locally