whatawhat 0.2.0

Application for monitoring user activity
Documentation

Whatawhat

A tool for monitoring activity on the computer throughout the day.

Why would I want this?

  • Because it's hard to remember what you've been doing 3 hours ago, let alone 1 week ago.
  • Because having no idea where your time goes will worsen your self-esteem.
  • Because knowing how much you spend on games might help you cope with addictions.

Introducing Whatawhat

A simple cli all-in-one tool for monitoring activity. The only tool you need is whatawhat cli and you're set.

No runtime required. No python, no node. The application is a single executable that takes up 1MB during execution.

Cli friendly. Very easy to use with tools like grep and less.

Everything is local. As long as your computer is safe, your data is safe.

Installation

Windows

cargo install -F win whatawhat

X11 Linux

To compile and run the application you need xcb and xscreensaver. Some distros (like Manjaro) will have them preinstalled.

To get utilities on Ubuntu you can simply run:

sudo apt-get install libxcb1-dev
sudo apt-get install xscreensaver

Then use cargo install to build the program:

cargo install -F x11 whatawhat

Usage

When you're first starting out it's recommended to run whatawhat init. This will start the daemon for the current session.

Now you can use the whatawhat timeline to get different data about your activity.

For details on how to run the deamon on boot refer to Autostart

Examples

Get application usage for this week.

whatawhat.exe timeline -d 1 -o days --start "last monday"

View the timeline for last 8 hours.

whatawhat.exe timeline -d 30 -o minutes --start "8 hours ago"

Whatawhat also works well with common cli utils like grep

View when you started and ended your day with head/tail

whatawhat.exe timeline -d 1 -o minutes --start "yesterday" --end  "yesterday" --days | tail

or

whatawhat.exe timeline -d 1 -o minutes --start "yesterday" --end  "yesterday" --days | head

View what YouTube videos you've been watching with grep

whatawhat.exe timeline -d 1 -o minutes --start "today" --days | grep YouTube

Autostart

Whatawhat doesn't run startup by default. This needs to be configured yourself.

For Windows you can refer to this:

  • Create a shortcut to whatawhat-daemon.exe.
  • Put the shortcut into the startup folder.
  • The daemon will now autostart on boot.

On Linux it's best to use autostart utilities provided by Gnome, KDE Plasma, etc.:

  • Add a new process on startup.
  • Specify the full path to the daemon (Usually /home/user/.cargo/bin/whatawhat-daemon.exe).
  • The daemon will now autostart on boot.