A cross-browser WebExtension that serves as a web browser watcher for ActivityWatch.

Install from official stores:

• Chrome Web Store
• Firefox Add-ons

Download the latest development build from our GitHub Actions:

1. Click on the latest successful workflow run
2. Scroll down to "Artifacts"
3. Download either firefox.zip or chrome.zip

Due to the above issue, a privacy notice must be displayed to comply with the Mozilla Add-on Policy. This can be pre-accepted by setting the following Firefox Enterprise Policy (More about Firefox Policies):

{
    "policies": {
        "3rdparty": {
            "Extensions": {
                "{ef87d84c-2127-493f-b952-5b4e744245bc}": {
                    "consentOfflineDataCollection": true
                }
            }
        }
    }
}

• Node.js (23 or higher)
• Git
• Make

1. Clone the repository with submodules:

git clone --recurse-submodules https://github.com/ActivityWatch/aw-watcher-web.git
cd aw-watcher-web

2. Install dependencies:

make install

3. Build the extension:

# For Firefox:
make build-firefox

# For Chrome:
make build-chrome

This will create zip files in the artifacts directory:

• artifacts/firefox.zip for Firefox
• artifacts/chrome.zip for Chrome

1. First follow the steps above to build the extension:

make install
make build-safari

2. Convert the extension to Safari format:

xcrun safari-web-extension-converter ./build

after finished, xcode will open automatically.

3. In Xcode:

• Select build target of macOS
• Build the project (⌘B)
• Run the extension (⌘R)

4. Enable the extension in Safari:
   • Open Safari
   • Go to Safari > Settings > Extensions
   • Enable "aw-watcher-web"

1. Extract artifacts/chrome.zip to a folder
2. Go to chrome://extensions
3. Enable "Developer mode"
4. Click "Load unpacked" and select the extracted folder

1. Build an Edge package:

make build-edge

2. Extract artifacts/edge.zip to a folder
3. Go to edge://extensions
4. Enable "Developer mode"
5. Click "Load unpacked" and select the extracted folder

Managed storage in Edge requires a Chromium managed schema and enterprise policy deployment:

• Manifest includes storage.managed_schema via schema.json (handled in this repo).
• Policy values are applied through Edge policy, not extension local storage.
• In most environments, unpacked developer-loaded extensions do not receive enterprise policy values. Use policy-installed extension deployment for managed values.

Example Windows registry policy path:

HKLM\Software\Policies\Microsoft\Edge\3rdparty\extensions\<EXTENSION_ID>\policy

Add policy values for keys defined in schema.json (for example CLOUD_SYNC, TAG, SUBDOMAIN, REGION) under that policy key.

1. Go to about:addons
2. Click the gear icon (⚙️) and select "Install Add-on From File..."
3. Navigate to and select the artifacts/firefox.zip file