Skip to content

temporaer/selfspy-vis

Repository files navigation

Visualization for selfspy | Plots for selfstats

Examples

🐭 Clicks

Last hours (bar chart)

Clicks Hours

Total (pie chart)

Clicks Total

🎹 Keystrokes

Last hours (bar chart)

Keystrokes Hours

Total (pie chart)

Keystrokes Total

Other visualizations

Not yet 🎅.

made-with-python


Command line

The graphs above have been generated by these commands.

You need to add selfvis.py in your PATH. And then run:

$ selfvis.py --human-readable --pactive --back 8 h

Or:

$ selfvis.py --human-readable --ratios --back 8 h

Installation

Install selfspy, then the requirements with pip :

$ pip install -r requirements.txt

You might need to give it sudo rights :

$ sudo pip install -r requirements.txt

Usage

The script is a modified version of the selfstats program. The same options apply. Try e.g.

$ python selfvis.py

Code status

Currently implemented is a breakdown of hours (stacked bar chart) and a pie chart (all time totals). Both plots are saved for clicks and for keypresses, respectively.

It's very likely that long intervals aren't split correctly.

🔧 Options

Filtering options of original selfstats continue to work. See here.


📝 Config

In ~/.selfspy/simplification_rules.txt, add rules of the form regexp --> name

For examples:

^\s*::\s*$ --> unknown
^(.+)::\s*$ --> \1
^(.+)::.*$ --> \1
# ^(.+)::(\w+).*$ --> \1:\2
^Firefox::.*YouTube.*$ --> Browser (Youtube)
^Firefox::.*GitHub.*$ --> Browser (GitHub)
^Firefox::.*Google Search.*$ --> Browser (search)
# ^.*Skype.*$ --> Skype
# ^.*Zimbra.*$ --> Mail
# ^.*\bmutt\b.*$ --> Mail
# ^.*\bzsh\b.*$ --> shell

to keep descriptions in legends short and expressive. Last matching rule (LHS) wins.

See this example for the rules I like.


FAQ 🔍

Q: Is there a nice webpage to display the graphs?

A: Yes, use this HTML file, host it locally.

  1. Download it raw from here,
  2. Put it somewhere where your local web server can find it (~/Public/, ~/www/ or whatever, depending on your system),
  3. Generate the graphs in the same folder (you can do it on a daily basis, e.g. with a cron job,
  4. Access the page on your web-browser. Tadaa!

It uses StrapDown.js.

Q: Is it supposed to be that slow?

A: Yup, don't expect your graphs to be produced in two seconds, it can take up-to 15 seconds.

A: Note: You can use an option to shorten the time window used for the plot: for instance selfvis.py --back 8 h only uses the data from the last 8h.

Q: Can I ...?

A: Yes, as long as you respect the terms of the GPLv3 License.


  • uLogMe: keep track of your computer activity throughout the day: visualize your active window titles and the number and frequency of keystrokes, in beautiful and responsive HTML timelines.
  • Munin, can also help to keep track of the uptime (and many more stats) of your (Linux) machine. See these plugins I wrote for my Munin.
  • My minimalist dashboard, generated every hour (with a crontab file), with this bash script GenerateStatsMarkdown.sh.

💁 About

📝 Authors?

📜 License ? GitHub license

GPLv3 Licensed (file LICENSE). © Lilian Besson, 2016.

Maintenance Ask Me Anything ! Analytics

ForTheBadge built-with-swag

ForTheBadge uses-badges ForTheBadge uses-git

ForTheBadge uses-html ForTheBadge uses-css ForTheBadge uses-js

About

Visualization of Selfspy Database

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published