Installing the Capo extension locally

Installing the extension from source can be useful if you’re a developer testing code changes, or a technical user looking to beta test the latest features. This guide takes you through the steps to install the extension locally.

Tip

Disable the production version of the extension and pin the local version to ensure that you’re always testing the latest changes.

1. Clone the Capo GitHub repository:

   git clone git@github.com:rviscomi/capo.js.git

2. Install dependencies and build the extensions:

   npm install
   npm run build

3. Load the built extension into your browser:

   For Chrome:

   • Navigate to chrome://extensions and enable Developer mode
   • Select Load unpacked and choose the newly generated dist/chrome subdirectory

   For Firefox:

   • Navigate to about:debugging
   • Click This Firefox on the left
   • Click Load Temporary Add-on… and select the manifest.json file inside the newly generated dist/firefox subdirectory

If you get the error Manifest file is missing or unreadable. Could not load manifest. in Chrome, make sure you’re loading the dist/chrome subdirectory, and not the top-level capo.js directory or the src directory.

If there are any other error messages, it’s possible that the latest source code has a bug. Please file an issue so we can investigate.