active-win-log

A window logging tool that tracks application usage

Usage no npm install needed!

<script type="module">
  import activeWinLog from 'https://cdn.skypack.dev/active-win-log';
</script>

README

active-win-log

A command line tool for logging time spent viewing application windows.

NPM Version semantic-release Coverage Status Dependencies status Dev-dependencies status

Install

npm install -g active-win-log

Usage

$ awl -?

Usage: awl <options>
awl           Start monitoring the active window
awl -?        This help information
awl -l n      Display statistics for the last "n" days in the log
awl -q        Stop monitoring
Log location: /users/<your user name>/.active-win-log/awl.json

Sample output

Command: awl -l 1 screen shot

Contributing

PRs are welcome. See CONTRIBUTING.md.

Motivation

I use this tool to give me a better sense of how I am spending my time when working out of the office. The tool checks to see what the active window is (using active-win) every 5 seconds.

Troubleshooting

"I start awl but it just shows the pid and an empty stats object"

This may be due to changes in MacOS 10.15 and later, which requires the [active-win](https://github.com/sindresorhus/active-win) library (which active-win-log depends on) to prompt for access when the library attempts to read a process' window title.

In the meantime, if you want active-win-log to work, you must grant access to your terminal program when OSX prompts for Accessibility and/or Screen-Recording access. (I know, this really sucks, but it's an OSX limitation. If you think you can improve this behaviour, see this issue.)

License

This software is licensed under the MIT Licence. See LICENSE.