Firefox Installation Guide
Table of contents
- From Firefox Add-ons (Coming Soon)
- Developer Installation
- Permissions Required
- Important Notes
- Troubleshooting
- Next Steps
From Firefox Add-ons (Coming Soon)
Coming Soon - Firefox Add-ons submission is in progress. For now, please use the developer installation method below.
Developer Installation
- Clone or download this repository
- Open Firefox and navigate to
about:debugging - Click This Firefox in the sidebar
- Click Load Temporary Add-on
- Select the
src/manifest-firefox.jsonfile
Permissions Required
The extension requires the following permissions:
- Host permissions for
*.inaturalist.org- To inject spectrograms on observation pages - webRequest and webRequestBlocking - To handle CORS headers for audio files
- tabs - To detect when you visit iNaturalist pages
Important Notes
- Firefox uses Manifest V2, which has different permission handling than Chrome
- The extension is loaded temporarily and will need to be reloaded after browser restart
- For permanent installation, wait for the Firefox Add-ons release
Troubleshooting
Extension doesn’t persist after restart
This is normal for temporary add-ons. You’ll need to reload it each time you restart Firefox, or wait for the official Add-ons release.
CORS errors in console
The Firefox version uses webRequest API instead of declarativeNetRequest. If you see CORS errors, ensure the extension has proper permissions.
Next Steps
Once installed, visit any iNaturalist observation with audio to see the extension in action!