The purpose of the OWL Window Logger is to help people who work mostly on computers better track what they spent their day working on.
- To work on Windows, OSX, and Linux
- To use very little memory while tracking activity.
An active window logger to help track time spent working in different computer applications and windows. Built in Python. Logs to JSON.
- OWL is built in Python.
- Log files are written to JSON to be consumable via many systems.
- Logging may be extended to write to CSV files or other formats.
OWL tracks and logs your computer system's:
- Active window titles
- Start and stop times when windows become active and stop being active
- Idle time
- Application thread names for active windows
- Other variables through easy module extension
For right now, I'll just summarize the plan for OWL.
OWL will eventually be part of a larger system for people to accurately record and analyze what projects and activities they worked in a given time period.
OWL is part one of a two part software set that is a combination desktop client which records activity and sends logged data to a rich internet application component that provides data analysis computation and end user report viewing.
Part 2 (a rich internet application component) is a long way off.
Until then, next steps include:
- basic analysis tools to summarize and review activity from day to day
- porting OWL to OSX and Linux
- testing and debugging
- packaging for easy distribution
-- It's a mature alpha.
- Works on Windows
- Coding for Linux and OSX are next.
- Installation is not hard, but it's not automatic yet.
- For Python programmers it will be easy.
- For programmers it should be pretty basic. You'll need to install some stuff.
- For non-programmers or non-major techies: We'll have an installer soon.
Clone or download the OWL project from:
https://github.com/seanbuscay/owlwindowlogger
git clone [email protected]:seanbuscay/owlwindowlogger.git
Make sure Python has permission to write to it.
Note: Anything in the logs directory is ignored by git so you can commit changes without sending your log data by accident.
The following need installed on your system if they are not already:
- Python 2.7x -https://www.python.org/getit/
- wxPython -https://www.wxpython.org/download.php
- Win32 -https://starship.python.net/~skippy/win32/Downloads.html
- psutil -https://code.google.com/p/psutil/wiki/Documentation#Classes
- (Optional) simplejson -https://github.com/simplejson/simplejson
- wx
- uuid
- win32gui
- time
- json (or simplejson)
- psutil
- win32process
Run from your Python editor tool for testing and debugging.
Run in the background to track work.
-https://docs.python.org/faq/windows.html#how-do-i-run-a-python-program-under-windows
Once executable:
- Double click owl.py
--OR--
- Create a shortcut to the owl.py file and put it in your startup folder.
- Testers
- Code Contributers
- Python Code Reviewers (I'm new to Python. Please critique.)
If you'd like to hack on OWL, start by forking the repo on GitHub:
https://github.com/seanbuscay/owlwindowlogger
The best way to get your changes merged back into core is as follows:
- Clone down your fork
- Create a thoughtfully named topic branch to contain your change
- Hack away
- If you are adding new functionality, document it in the README
- If necessary, rebase your commits into logical chunks, without errors
- Push the branch up to GitHub
- Send a pull request to the github/owlwindowlogger project.
Code samples and posts that have helped in developing OWL Window Logger:
- The code that helped get me started: -https://scott.sherrillmix.com/blog/programmer/active-window-logger/
- The gollum project readme file which helped write this readme doc. -https://raw.github.com/github/gollum/master/README.md -https://github.com/github/gollum
See: https://github.com/seanbuscay/owlwindowlogger/issues?labels=known+issue