Code Monkey home page Code Monkey logo

suriyaavijay / digital-wellbeing Goto Github PK

View Code? Open in Web Editor NEW
1.0 2.0 0.0 230 KB

Digital Wellbeing for Linux is an open-source project designed to promote healthy digital habits and improve overall well-being. With a focus on monitoring screen time, managing app usage, and providing valuable insights, this project aims to empower users to take control of their digital lives.

License: MIT License

CSS 6.65% HTML 33.62% JavaScript 27.39% Shell 11.35% Python 20.99%
css digital-wellbeing html javascript linux python screen-time shell ubuntu

digital-wellbeing's Introduction

Digital-Wellbeing

This project aims to bring the digital wellbeing and screen time management features, similar to those found in Samsung Android phones, to Linux operating systems. The project is primarily built using HTML, JavaScript, and Python, with additional programming in Shell and CSS. For further help refer link

Getting Started

To start recording

  1. Clone the repository to some folder: $ git clone https://github.com/SuriyaaVijay/Digital-Wellbeing.git
  2. If you're on Ubuntu, make sure you have the dependencies: $ sudo apt-get install xdotool wmctrl. On Fedora, you may also need sudo yum install gnome-screensaver.
  3. cd inside and run $ ./ulogme.sh (note: this will ask you for sudo authentication which is required for showkey command). This will launch two scripts. One records the frequency of keystrokes and the other records active window titles. Both write their logs into log files in the logs/ directory. Every log file is very simply just the unix time stamp followed by data, one per line.

The user interface

  1. Important. As a one-time setup, copy over the example settings file to your own copy: $ cp render/render_settings_example.js render/render_settings.js to create your own render_settings.js settings file. In this file modify everything to your own preferences. Follow the provided example to specify title mappings: A raw window title comes in, and we match it against regular expressions to determine what type of activity it is. For example, the code would convert "Google Chrome - some cool website" into just "Google Chrome". Follow the provided example and read the comments for all settings in the file.
  2. Once that's set up, start the web server viewer: $ python ulogme_serve.py, and go to to the provided address) for example http://localhost:8123) in your browser. Hit the refresh button on top right every time you'd like to refresh the results based on most recently recorded activity
  3. If your data isn't loading, try to explicitly run python export_events.py and then hit refresh. This should only be an issue the very first time you run ulogme.

Features

  1. Screen Time Monitoring: Keep track of the time you spend on your Linux device and monitor your daily usage patterns.
  2. App Usage Statistics: Get detailed insights into the apps you use the most and how much time you spend on each app.
  3. App Limits: Set limits on the usage of specific applications to encourage a healthy balance between screen time and other activities.
  4. Usage History: View your historical data to track your progress and make informed decisions about your digital habits.
  5. User Profiles: Create individual profiles for different users to personalize their digital wellbeing settings.

digital-wellbeing's People

Contributors

suriyaavijay avatar

Stargazers

 avatar

Watchers

 avatar  avatar

digital-wellbeing's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.