What it does, how to install it, and what to do when dtangle says it has stopped.
Without the extension, dtangle can still see that your browser was open and for how long. It cannot see where you went. So a research session and a two hour detour look identical: both arrive as "time in Chrome" with nothing attached.
The extension is the only thing that supplies the site. It reports the domain when you navigate or switch tabs, and nothing else: no page contents, no keystrokes, no form data. Query strings are stripped before anything leaves the browser, so a URL carrying a password reset token or a search term is recorded as the page, not the parameters. Private and incognito windows are never recorded at all.
All of these run the same build. Install it once per browser, on every machine you use dtangle on, since an extension installed on your laptop does nothing for your desktop.
chrome://extensions (or edge://extensions, brave://extensions).about:debugging#/runtime/this-firefox.manifest.json from the unzipped folder.There is no dtangle extension for Safari and there cannot be one without a separate Safari App Extension shipped through the App Store. dtangle reads Safari URLs a different way, using AppleScript, which needs the Automation permission rather than an extension. dtangle will never ask you to install an extension for Safari.
This one is not your fault and it is the most common thing that goes wrong. Chrome runs extensions as a service worker and shuts that worker down when it looks idle. Normally it wakes again on the next tab switch. Occasionally it does not, and the extension sits there listed and enabled while sending nothing.
The fix takes five seconds. Open chrome://extensions, find
dtangle, and click the circular reload arrow on its card. That is all. You do
not need to remove it, reinstall it, or restart anything.
If the card shows Errors or the service worker reads Inactive and never wakes, reload it the same way. dtangle notices within a few hours of browsing that no reports are arriving, which is why you saw the warning before you noticed anything yourself.
| dtangle says | What happened | What to do |
|---|---|---|
| No browser extension | It was never installed on that machine | Install it |
| Browser extension stopped | It was working and went quiet | Reload it |
dtangle tracks each machine separately, so the warning always names the one that needs attention. Installing the extension on your laptop will not clear a warning about your desktop. Your Devices page lists every machine with its own status, which is the quickest way to see which one is missing something.
Browse normally for a few minutes, then open your Devices page. The warning on that machine disappears once reports start arriving. Nothing needs restarting and you do not need to dismiss anything: the notice clears itself.
Still stuck? The FAQ covers what dtangle records and how to turn things off.