Chrome Installation Guide

Table of contents

  1. From Chrome Web Store (Recommended)
  2. Developer Installation
  3. Permissions Required
  4. Troubleshooting
    1. Extension doesn’t appear on iNaturalist pages
    2. No spectrogram appears
  5. Next Steps

Coming Soon - Chrome Web Store submission is in progress. For now, please use the developer installation method below.

Developer Installation

  1. Clone or download this repository
  2. Open Chrome and navigate to chrome://extensions
  3. Enable Developer mode (toggle in the top-right)
  4. Click Load unpacked and select the src/ directory of this extension
  5. CRITICAL: Click Details on this extension and ensure Site access is set to “On all sites”

Permissions Required

The extension requires the following permissions:

  • Host permissions for *.inaturalist.org - To inject spectrograms on observation pages
  • declarativeNetRequest - To handle CORS headers for audio files
  • webNavigation - To detect when you visit iNaturalist pages

Troubleshooting

Extension doesn’t appear on iNaturalist pages

  1. Ensure the extension is enabled in chrome://extensions
  2. Check that “Site access” is set to “On all sites”
  3. Refresh the iNaturalist page

No spectrogram appears

  1. Verify the observation has audio content
  2. Check the browser console for [iNatSpectro] messages
  3. Try a different observation to rule out audio format issues

Next Steps

Once installed, visit any iNaturalist observation with audio to see the extension in action!

Learn how to use iNatSpectro →