Hark Browser Extension

Recording control panel for the harkd daemon. Start, stop, and monitor recordings directly from your browser toolbar — with automatic recording for Google Meet and Microsoft Teams calls.

Features

• Manual recording — one-click start/stop with live audio level visualization and duration timer
• Auto-record meetings — automatically record when joining Google Meet or Microsoft Teams
• Live feedback — audio levels, recording duration, processing progress, and recent recordings
• Title sync — edit recording titles in real-time during a session
• Crash recovery — persists state to survive extension restarts mid-recording

Prerequisites

• Firefox 109+
• A running harkd daemon (default: http://127.0.0.1:8765)
• Bun (for development/testing only)

Installation

Temporary (development)

1. Open about:debugging#/runtime/this-firefox
2. Click Load Temporary Add-on
3. Select firefox/manifest.json

Permanent

Package and sign via web-ext:

bunx web-ext build -s firefox/
bunx web-ext sign -s firefox/ --api-key=... --api-secret=...

Development

No build step — all source files are plain JS loaded directly by the browser.

Install dev dependencies (linting only):

bun install

Running Tests

Tests use node:test with node:vm to load extension scripts into isolated contexts.

bun run test

Linting

bun run lint

Configuration

Open the extension's Options page to configure:

Setting	Description
Daemon URL	Address of your harkd instance (default: http://127.0.0.1:8765)
Auto-record	Automatically start recording when joining Meet/Teams calls

For non-localhost daemon URLs, the extension will request additional host permissions.

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'feat: add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the GNU Affero General Public License v3.0.