Managing a watcher afterwards

Everything about a watcher you've already created — editing, watching it run, and removing it — happens from the Data sources page.

The custom watchers table

Every watcher you've created shows up here, even before it has produced any data yet. Each row has three actions: Open (jump to its detail page), export as CSV, and delete.

Deleting a watcher is complete — it stops the running process, deletes its folder from disk, and deletes its stored data, all in one step. It's not just removing the module from your Home page; there's nothing left behind to accidentally resurrect itself.

The detail page

Clicking "Open" on a custom watcher shows some extra information you won't see for built-in modules:

• Process status — whether it's currently running, and its mode.
• Poll interval — how often it's re-run, in minutes.
• File to run — an editable field. Change it to point at a different script at any time (it must stay in the watcher's own folder — no other path is allowed); TrackFlow detects the right interpreter from the new file's extension (see Writing the watcher script) and restarts the watcher immediately with the new file.
• A live log window, at the bottom of the page. It shows, in real time: when the watcher was created, every time it started running (with the exact command it used), the data it read on each run, timeouts, and any errors — the fastest way to tell whether TrackFlow failed to launch your script at all, or whether your script ran but returned something unexpected. Log entries older than seven days are cleaned up automatically.

If you remove the Home module by mistake

The watcher itself keeps running even if its module disappears from Home — data isn't lost. To bring it back: on Home, click "Edit modules" → "+ Add module", pick "Custom watcher data" from the type picker, and select your watcher by name from the list. It reappears at the same width you originally chose for it — see Visualization templates for what the different sizes look like.