Extension troubleshooting

The popup says “Not paired” or sits on “Connecting…”

Cause: the extension can’t reach the Vetroscope desktop app.

Fix, in order:

1. Is Vetroscope running? The extension only works while the app is in your tray. Launch it and re-check the popup a few seconds later.
2. Restart the browser. Browsers only look for Vetroscope when they start — if you installed the extension before Vetroscope, a restart fixes it. After some app updates, a message asks you to restart the browser once so it connects through the new version.
3. Update the app. Fixes for connecting come in app updates (Settings → About → Check for Updates), so it’s worth updating before anything else. You usually don’t need to update the extension.
4. Safari only: confirm the extension is enabled in Safari → Settings → Extensions, and open the Vetroscope for Safari companion app once after installing.

Sites aren’t showing under the browser

Cause: usually a setting that’s been switched off.

Fix: check, in the extension popup, that it isn’t Paused and the site isn’t in Ignored sites; in the app, that Track web browsing is on (Settings → Activity Tracking) and the browser isn’t in an ignore list. Remember that only the tab you’re looking at, in the browser window you’re using, counts as browsing time — a browser in the background only counts music and video.

Media isn’t tracked, or has no link

Cause: music and video have their own settings.

Fix: in Settings → Activity Tracking, confirm Track web browsing is on — with it off, media in your browser isn’t recorded or shown in Now Playing, even with the extension installed. For media in tabs you aren’t looking at, Track music must be on too; the tab you’re watching counts as web browsing. For links, turn on Capture media links. A muted tab that produces no sound may not count as playing on some sites.

Still stuck?

Report a bug — mention the browser name and version, and what the popup’s status dot shows.