This repository has been fully moved to codeberg.

For further updates, Issues and pull requests please view it there.

---

📊 Screentime

A lightweight, user-friendly application to monitor your PC usage on Linux and Windows. Track your screen time, and go touch Grass.

What is Screentime?

Like the Name suggests it is a Screentime monitoring Tool, for Windows and Linux. It has useful Statistics, low resource Usage and no unneccessary Bloat. It doesnt have any branding, because i thought it would be better if it was just a simple 'default' Screentime App.

Features

• 📈 Real-time Monitoring – Track active screen time as you use your computer
• 🖥️ Cross-Platform Support – Works on Linux and Windows
• 📊 Detailed Analytics – View Statistics on how you used your device over any period
• ⚡ Lightweight – Minimal resource consumption, runs smoothly in the background
• 🎨 User-Friendly Interface – Simple and intuitive design
• 🔄 Automatic Tracking – Set it up once and it just works 'out of the Box'

Getting Started

Prerequisites

• Python 3.7 or higher
• Linux or Windows operating system

Installation

1. Clone the repository:

git clone https://github.com/truelockmc/Screentime.git
cd Screentime

2. Install dependencies:

pip install -r requirements.txt

3. Run the application:

python main.py

Usage

Simply start the application and it will begin monitoring your screen time automatically. Your usage data will be displayed in an easy-to-understand format.

By default the Application runs itself on startup, you can change this in the Settings.

Testing

This Program has been tested to work best on Linux with GNOME as this is the System i am using. It has also been tested to work on XFCE and Windows, but the App Names are not recognized as good sometimes.

Wayland

Full per-application tracking now works under KDE Plasma / Wayland via an optional KWin script (screentime-kwin, included in this repo under kwin-extension/). For other DE's or without this script installed/active, time on wayland will be counted as a generic "Wayland PC" entry.

Setup (KDE Plasma only)

(in the project's root dir)

kpackagetool6 --type=KWin/Script -i kwin-extension/

Then enable it in System Settings → Window Management → KWin Scripts. Or with the kwriteconfig6 tool:

kwriteconfig6 --file kwinrc --group Plugins --key screentime-kwinEnabled true && qdbus6 org.kde.KWin /KWin reconfigure

Note: The package name of qdbus may differ on your system.

📝 License

This project is licensed under the GNU General Public License v3.0 – see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request to help improve Screentime.

💬 Questions or Issues?

Have a question or found a bug? Open an issue and let me know!

---

Made with ❤️ by truelockmc