Skip to content

Browser extension

The Gero browser extension lets you import videos, audio tracks, and create media subscriptions directly from any webpage. Available for Chrome and Firefox.

Chrome installation

  1. Download the latest extension files from the Dropbox folder (or the src/Web.Extension/chrome/ folder if building from source)
  2. Open Chrome and navigate to chrome://extensions/
  3. Enable Developer mode using the toggle in the top-right corner
  4. Click Load unpacked
  5. Select the chrome/ folder containing the extension files
  6. The Gero icon appears in your toolbar — click it to open the popup

Pin the extension

After installing, click the puzzle piece icon () in Chrome's toolbar and pin Gero for quick access.

Firefox installation

  1. Download the latest extension files from the Dropbox folder (or the src/Web.Extension/firefox/ folder if building from source)
  2. Open Firefox and navigate to about:debugging#/runtime/this-firefox
  3. Click Load Temporary Add-on...
  4. Select any file inside the firefox/ folder (e.g., manifest.json)
  5. The Gero icon appears in your toolbar

Temporary add-on

Firefox temporary add-ons are removed when the browser closes. For persistent installation, the extension needs to be signed and distributed through Mozilla Add-ons (AMO).

Configuration

After installing, you need to point the extension to your Gero instance:

  1. Click the Gero extension icon in your toolbar
  2. Click the gear icon () to open settings
  3. Set the API URL to your Gero API address (e.g., https://localhost:7001)
  4. Set the Web app URL to your Gero web interface address (e.g., https://localhost:5001)
  5. Click Save

The status indicator at the top of the popup shows the connection state:

  • Green — Connected to the API
  • Red — Cannot reach the API

Default URLs

The extension defaults to https://localhost:7001 (API) and https://localhost:5001 (web app). If you're running Gero with the default configuration, you may not need to change anything.

Usage

Click the extension icon to open the popup. The current page URL is automatically filled in.

Choose what to import:

Action Description
Video Import a video via yt-dlp. Optionally set a custom name.
Audio Import an audio track. Optionally set title, artist, and category.
Subscription Create a media subscription to monitor the URL for new content. Set a schedule and optional description.

Click the import button and wait for the confirmation message.

Context menu

Right-click any page or link to access Gero actions:

  • Import video — sends the page or link URL to Gero for video import
  • Import audio — sends the URL for audio track import
  • Add media subscription — creates a subscription for the URL

The extension shows a desktop notification when the action completes.

Troubleshooting

Problem Solution
Status indicator is red Check that your Gero API is running and the API URL in settings is correct
"Failed to fetch" errors Your browser may block requests to localhost with self-signed certificates. Visit the API URL directly in a new tab and accept the certificate
Extension disappeared (Firefox) Temporary add-ons are removed on browser restart. Re-load the extension via about:debugging
Import button stays loading Check the browser console (F12) for error details