https://github.com/nooo37/ticktack

Automated time tracker for the X11 windowing system
https://github.com/nooo37/ticktack

Last synced: 18 days ago
JSON representation

Automated time tracker for the X11 windowing system

• Host: GitHub
• URL: https://github.com/nooo37/ticktack
• Owner: Nooo37
• Created: 2021-01-05T19:29:09.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2021-05-20T14:29:53.000Z (over 3 years ago)
• Last Synced: 2024-10-11T02:53:39.029Z (about 1 month ago)
• Language: Shell
• Homepage:
• Size: 5.86 KB
• Stars: 5
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.org

Awesome Lists containing this project

README

        
#+Title: ⏰ ticktack

#+Author: 37

** Why?

I'm a fan of tracking everything especially if tracking it comes at zero cost. That's why I used [[https://github.com/ActivityWatch/activitywatch][ActivityWatch]] for a long time on Windows. ActivityWatch is a great and very user-friendly open source project. Unfortunately I only got it working very inconsistently on Linux which is obviously a big pain when trying to track your behavior over a longer period of time. It also used more resources and was less hackable than I would have liked. So I decided to give up on ActivityWatch and replace it with this small shell script (to be fair ActivityWatch adds more than that: It also has great browser integration, a localhost web interface and so on).

** Examples

To start the daemon, my PC runs this command on every startup (the =-m= flag only specifies how much time can pass without making a database entry - it defaults to eight):

#+begin_src shell

ticktack start -m 30

#+end_src

To check how long I've been focusing the emacs window on the current day, I would do:

#+begin_src shell

ticktack query --begin "$(date -d 'today 00:00:00' '+%s')" --sum class

#+end_src

To check how long I've been on my PC yesterday, I would do:

#+begin_src shell

ticktack query --begin "$(date -d 'yesterday 00:00:00' +'%s')" --end "$(date -d 'today 00:00:00' '+%s')" --sum all

#+end_src

You get the idea. Querying features are currently a little limited but sufficient and very simple. The only database is located at =$XDG_DATA_HOME/ticktack.db=.