#utility #command-line-tool #screentime

app screentime

A lightweight screentime monitoring tool

9 releases

0.2.5 Nov 3, 2022
0.2.4 Oct 30, 2022
0.1.2 Oct 2, 2022

#993 in Command line utilities

29 downloads per month

MIT license

334 lines

A screentime monitoring tool, shows how much time are you really using certain apps. It work nicely with i3status or py3status on I3 window manager for example :)



From crates.io:

cargo install screentime


yay screentime (or other AUR manager)


cargo install


screentime --help

A screentime monitoring tool. Firstly, start this program with no arguments (daemon mode)

Usage: screentime [OPTIONS] [COMMAND]

          Client commands

          Possible values:
          - hms:         Print total screentime in HH:MM:SS format
          - total:       Print total screentime in seconds
          - summary:     Print a nice-looking summary
          - raw-summary: Print a summary in raw JSON

  -c, --config <FILE>
          Specify a config path

  -h, --help
          Print help information (use `-h` for a summary)


Config path: $HOME/.config/screentime/config.toml


  • port (The port for the listening deamon (default 9898)
  • seconds_before_afk (After how much seconds of inactivity assumes AFK (default 30)
  • snapshot_interval_in_seconds (How often program saves its state on disk (default 10)

How it works:

It just maintains a counter HashMap updated every second by one thread. Other thread has an HTTP API for the client to access the usage time. It uses only cross-platform libraries, so it should work on all three popular OSes.


  • Linux, Windows and MacOS
  • Measure total screentime
  • AFK feature
  • Configurable
  • Simple client in a binary


Feel free to open an issue, or just make a pull request. If you see any improvements to make the code better in any way, open a PR. I'd be happy to welcome new contributors :)


~655K SLoC