Skip to content

baebranch/data_tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Data Tracker

A lightweight desktop widget built with Flet that displays real-time network data usage. It floats on top of all windows and provides live tracking of data consumption since midnight, including hourly usage graphs and notifications.

Features

  • Real-time Tracking: Monitors network data usage (sent/received) since midnight.
  • Hourly Graph: Visual bar chart showing data usage per hour of the day.
  • Always-on-Top: Floats above all other windows for constant visibility.
  • Notifications: Alerts when a configurable amount of data (in MB) has been consumed.
  • Persistent Storage: Saves usage data across restarts.
  • Minimal UI: Compact design with opacity changes on hover.
  • Taskbar Hidden: Icon is not shown in the Windows taskbar for a cleaner desktop experience.

Screenshots

Transparent (default state)

Transparent

Opaque (on hover)

Opaque

Requirements

  • Python 3.8+
  • Windows (current release target)

Running the Application

For End-Users (Windows)

  1. Download the latest Data Trakcer.exe from the Releases page.
  2. Double-click the .exe to run. No installation required.
  3. The widget will appear and start tracking your network data usage.

For Developers

  1. Clone the repository:

    git clone https://github.com/baebranch/data_tracker.git
    cd data-tracker
  2. Create a virtual environment:

    python -m venv .venv
    .\.venv\Scripts\activate
  3. Install dependencies:

    pip install -r requirements.txt
  4. Run the application:

    python main.py

Building

Use the VS Code task "Build with Flet" or run:

flet pack main.py --name "Data Tracker" --icon favicon.ico

This creates a standalone executable using PyInstaller.

Usage

  • The widget appears as a small window showing current data usage.
  • Hover to make it fully opaque.
  • Data resets at midnight.
  • Hourly bars update in real-time, with the current hour highlighted.

Configuration

  • Notification threshold: Currently hardcoded; modify main.py to customize.
  • Window position and size: Adjustable in main.py.

Development

  • Uses Flet for cross-platform UI.
  • Hot reload available via VS Code debug configuration.
  • Data stored in data/network_data.json.

License

MIT License - see LICENSE for details.

About

A simple always on top data tracker for windows. Sends a desktop notification periodically so data usage isn't over looked.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages