Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/waishnav/watcher
Minimal open source Screen-Time Tracker for Linux
https://github.com/waishnav/watcher
activitywatch activitywatch-alternative app-usage arch-linux css debian hacktoberfest html javascript linux minimal productivity python react real-time screen-time tracker watch-your-activity watcher watcher-cli
Last synced: about 11 hours ago
JSON representation
Minimal open source Screen-Time Tracker for Linux
- Host: GitHub
- URL: https://github.com/waishnav/watcher
- Owner: Waishnav
- License: mit
- Created: 2022-03-08T18:25:49.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-11-13T07:46:48.000Z (3 months ago)
- Last Synced: 2025-01-26T08:10:27.145Z (8 days ago)
- Topics: activitywatch, activitywatch-alternative, app-usage, arch-linux, css, debian, hacktoberfest, html, javascript, linux, minimal, productivity, python, react, real-time, screen-time, tracker, watch-your-activity, watcher, watcher-cli
- Language: Python
- Homepage:
- Size: 12.2 MB
- Stars: 175
- Watchers: 2
- Forks: 14
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Watcher
### Minimal Open source Screen-Time Tracker (CLI-app)
Note: codebase in the python is being under migration in golang, you can checkout `go-migrate` branch for more info.
## Table of Contents
- [About](#about)
- [Gallery](#gallery)
- [Installation](#installation)
- [Want to Contribute](#want-to-contribute)
- [Todo](#to-do)
## About
Watcher is CLI-app (at this moment) which helps you to get perspective about your Screen-time
## Gallery
| Day Summary | Week Summary |
| :-------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------: |
|  |  |
Funfact: You might be thinking how can someone has 14 hrs of screen time in a single day, Well ! short ans is AFK-feature is not implemented yet... Most of the time I left my laptop as it is so it also counts that AFK time as Screen-time
## Installation
- Note: Install [`xprintidle`](https://github.com/g0hl1n/xprintidle) and [`xdotool`](https://github.com/jordansissel/xdotool) on your system ( the only dependancies other than python3 ). Install [`python3`](https://www.python.org/downloads/) if not installed in your machine.
- First, Install the following dependancy `xprintidle` and `xdotool`
```bash
$ sudo [package-manager] install xprintidle xdotool
```
- Second, Copy the Following Command and paste in terminal
```bash
$ bash <(curl -s https://raw.githubusercontent.com/Waishnav/Watcher/main/install)
```
- Then run install script
```bash
$ chmod +x ./install && ./install
```
### Want to Contribute
If you are interseted in contibuting checkout [CONTRIBUTING.md](https://github.com/Waishnav/Watcher/blob/main/CONTRIBUTING.md)
You can currently contribute to one of the three projects listed below throughout the HACTOBERFEST.
- [Watcher Website](https://github.com/Waishnav/Watcher-web) (made with React)
- [Watcher v1.0](https://github.com/Waishnav/Watcher/tree/v1.0) (No real time updates in logfile)
- [Watcher v2.0](https://github.com/Waishnav/Watcher/tree/v2.0) (Real time stats in logfile)
To contribute, clone the relevant branch anywhere you wish to.
## To-do
- [x] AFK feature
- [ ] GUI only if got 300 stars Probably [Tauri App](https://github.com/tauri-apps/tauri).