Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Window Time Plugin for Super Productivity

A window-activity tracker for Super Productivity that records which application had the foreground and for how long, subtracts the time you were away, and reports it per application, site and window title — on its own page and as blocks on the Schedule.

Task time stays with Super Productivity's own tracker. Window Time adds the other half of the picture: what the screen was showing while the clock ran. Everything is stored locally; nothing recorded ever leaves your machine.


Features

  • Automatic recording — samples the foreground window every second: application, window title, and for browsers the page address without its query string
  • Idle time removed — stretches where the system reports you as away (five minutes by default) are subtracted from the totals; short pauses still count
  • Any range — today, yesterday, this week, the last 7 or 30 days, this month, or a custom range
  • Overview — total active time, idle time removed, a timeline of each day, and time per application with the sites or window titles underneath
  • Browser details, your way — a browser window can be shown as its site with the pages opening underneath, as one row per page with the site in front, or as the site alone — the last records no page titles at all
  • On the Schedule — registers as a calendar, so today's activity appears as blocks beside your other calendars, with a hover card showing which windows made up each block
  • Site icons — websites are listed with their own icon, if you switch it on; off by default, since fetching an icon means a request to that site
  • Export — CSV that opens straight into Excel, or JSON
  • One switch — recording is toggled from the page header and saves immediately

Settings

The gear at the top right of the page opens three panels.

Section What you can change
Recording Record window activity, subtract idle time and the threshold that counts as away, site icons, and how browser windows are recorded and shown
Data management Which folder the day files live in, the CSV and JSON export, clearing the stored application icons, and deleting everything recorded in one go
Status What the timer and the background recorder report right now — including the window in front at this moment — with a retry of the module download for when the automatic one did not get through

Installation

  1. Download window-time.zip from the latest Release
  2. Open Super Productivity — the desktop app, version 18.19.0 or newer
  3. Go to Settings → Plugins, upload the zip, and enable it
  4. Answer Allow when the app asks whether this plugin may run Node.js code — without it there is nothing to record with
  5. Open Window Time from the left menu, click the gear, switch on Record window activity, and save

The first time recording starts, the plugin fetches the small module it uses to read the foreground window (about 0.6 MB, from the public npm registry, integrity-checked) into its own data folder. Node.js and npm do not need to be installed on your machine, and on 64-bit Windows the plugin carries an offline copy as a fallback. An installation of your own goes under xwin/ in the data folder, where the plugin looks for it.

To see it on the Schedule, open the issue-provider setup with the + at the top of the issue panel on the right, find Window Time under the calendar providers, and add it. Blocks then refresh every two minutes. Leave Auto import to default project off; no tasks are ever created from your activity.


Your data

  • Local, plain text. One file per day in a folder you choose, SuperProductivity-WindowTime in your home directory by default. Readable in any text editor, deletable with one button.
  • Not synced. Super Productivity's sync carries this plugin's settings, never your recorded activity.
  • Recorded: application name, window title, and for browsers the address without query string or fragment — or, with Browser details set to domains only, just the site. Not recorded: keystrokes, clipboard, screenshots, page contents.
  • Network: the one-time module download above, and — only while Site icons is on — a request to each visited site for its icon, at most once a month per site. Switch site icons off and the plugin contacts nothing at all.

It also does not start or stop your task tracking, and never assigns window time to a task.


Roadmap

  • A visibility toggle on the Schedule. Super Productivity can hide individual calendars from the Schedule, but that menu currently lists iCal calendars only, so Window Time cannot be switched off there yet.
  • More analytics. Further views of what is recorded; ideas to follow.

About

Window activity tracking plugin for Super Productivity: which window was in front, for how long, per application, site and page

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages