ScreenTimeTracker - GitLite

KO | EN

gitlite — search

#javascript #react #ai #typescript #llm #go #rust #deep-learning #docker #macos #awesome #awesome-list #openai #open-source

ScreenTimeTracker

(★ 139)

An intuitive, lightweight, and privacy-first Windows desktop app to track screen time and application usage habits.

File Explorer

Download Latest Version (.zip)

- logo.svg
- screenshot1.jpeg
- screenshot1_zh-CN.jpeg
- screenshot2.jpeg
- screenshot2_zh-CN.jpeg
- screenshot3.jpeg
- screenshot3_zh-CN.jpeg
- screenshot4.jpeg
- screenshot4_zh-CN.jpeg
- - .gitignore
  - .oxlintrc.json
  - index.html
  - package.json
  - pnpm-lock.yaml
  - tsconfig.app.json
  - tsconfig.json
  - tsconfig.node.json
  - vite-env.d.ts
  - vite.config.ts
- - ScreenTimeTracker.BuildingBlocks.csproj
- - .gitignore
  - package.json
  - pnpm-lock.yaml
  - pnpm-workspace.yaml
  - tsconfig.json
  - wxt.config.ts
- - ScreenTimeTracker.ArchitectureTests.csproj
  - xunit.runner.json
- - ScreenTimeTracker.Testing.csproj
  - xunit.runner.json
.editorconfig
.gitignore
Directory.Build.props
Directory.Packages.props
dotnet-tools.json
global.json
LICENSE
README.md
README_zh-CN.md
ScreenTimeTracker.slnx

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">

# Screen Time Tracker

**English** | [简体中文](README_zh-CN.md)

[![Discord](https://img.shields.io/badge/Discord-Join%20Community-5865f2?style=flat&logo=discord)](https://discord.gg/PxqGwcsVuh) [![QQ Group](https://img.shields.io/badge/QQ%20Group-Join%20Group-1ebafc?style=flat&logo=qq)](https://qm.qq.com/q/uiwJZiQRAm)

</div>

## Overview
A simple and lightweight Windows desktop app for tracking screen time, helping you gain insights into your computer usage, boost productivity, and maintain a healthier work-life balance.

<details>
<summary>Click to view screenshots</summary>
<p align="center">
    <img src="./assets/screenshot1.jpeg" width="90%">
    <img src="./assets/screenshot2.jpeg" width="90%">
    <img src="./assets/screenshot3.jpeg" width="90%">
    <img src="./assets/screenshot4.jpeg" width="90%">
</p>
</details>

## Key Features
- **Time Tracking**: Runs silently in the background, accurately recording the duration spent on each application.
- **Website Usage Statistics**: When used with a browser extension, it can track the amount of time spent on websites.
- **Visual Analytics**: Provides a rich variety of intuitive charts and statistics, allowing you to clearly understand your time distribution.
- **Privacy First**: All data is stored locally and never uploaded to the cloud, guaranteeing your personal privacy.
- **Lightweight & Efficient**: Ultra-low CPU and RAM usage, ensuring it won't impact your daily experience.
- **Highly Configurable**: Offers detailed configuration options to cater to different user requirements.
- **Multilingual Support**: Native support for both English and Simplified Chinese interfaces.

## Download
You can download the application from [Releases](https://github.com/majianchuan/ScreenTimeTracker/releases) or build it yourself.

## Tech Stack
### Backend
* .NET 10.0 (C#)
* ASP.NET Core Web API
* FastEndpoints
* Entity Framework Core
* SQLite
* Mediator
### Frontend
* React
* TypeScript
* Vite
* Material UI (MUI)
* TanStack Query
* TanStack Router
* i18next
* Zod
* ECharts
### Desktop
* Photino.NET
* H.NotifyIcon

## Architecture Overview
The backend follows a Modular Monolith architecture, with individual modules organized using Vertical Slice Architecture.  
The frontend follows Feature-Sliced Design (FSD).  
When the application starts, it launches a local backend API service. The frontend is loaded into the WebView provided by the Photino.NET desktop shell and communicates with the backend through the local API.

## Development
- **Prerequisites**
  - .NET SDK 10.0+
  - Node.js 22.12.0+
- **Clone Repository**:
  ```shell
  git clone https://github.com/majianchuan/ScreenTimeTracker.git
  ```
- **Build Frontend**:
  ```shell
  cd src/frontend
  pnpm install
  pnpm build
  ```
- Build the browser extension (optional):
  ```shell
  cd ../web-extension
  pnpm build
  ```
  The build output will be generated in the `.output` directory.
- **Run Application**:
  ```shell
  cd ../Hosts/ScreenTimeTracker.Desktop
  dotnet run
  ```

## Community & Feedback

If you encounter any issues or have feedback and suggestions, feel free to join our community:

- **Discord Community**: [Join Discord](https://discord.com/invite/PxqGwcsVuh)
- **QQ Group**: [Join QQ Group](https://qm.qq.com/q/uiwJZiQRAm)