Skip to content

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AppTrackr

A Windows desktop app that tracks which applications you actually use, and for how long. Time is counted only while an app has focus, so the numbers reflect reality rather than just "was it open."

Screenshots

Dashboard

Dashboard

Calendar

Calendar

Apps

Apps

Features

  • Foreground-only tracking. Background time is never counted. If you switched away, the clock stops.
  • Idle detection. Configurable idle threshold (default 5 minutes) pauses tracking when you step away.
  • Dashboard. Live view of what you are currently using, today's total, this week's total, and your top apps.
  • Calendar view. Browse usage by day to spot patterns over time.
  • Per-app detail. Open any app to see its full session history and totals.
  • Rewards system. Optional progression layer with XP, levels, credits, and a resource-collection mini-game tied to your usage goals. Can be disabled entirely.
  • Streak tracking. Keeps a daily streak for apps you have marked as favorites, based on 30+ minutes of focused use.
  • Theme presets. Several accent color options. Changes apply on next launch.
  • System tray and autostart. Minimize to tray and optionally launch at login via the Windows registry.
  • Data export. Export your history to CSV or JSON. Backup and restore the SQLite database directly.
  • In-app updates. Point the update feed at a GitHub releases API endpoint and check manually or automatically on startup.

Requirements

  • Windows 10 or 11
  • Python 3.10 or newer (for running from source)

Installation

Download the latest release from the Releases page.

Standard installer (recommended)

  1. Download AppTrackr_Setup.exe.
  2. Run the installer and follow the prompts.
  3. Launch AppTrackr from the Start Menu or desktop shortcut.

Portable build

  1. Download AppTrackr_Portable.zip.
  2. Extract it anywhere.
  3. Run AppTrackr.exe.

Developer Setup

Clone the repo and install in editable mode with dev dependencies:

pip install -e ".[dev]"

Run the app:

python -m apptrackr

Building from Source

PyInstaller bundle

pyinstaller packaging/apptrackr.spec

Inno Setup installer

  1. Open packaging/installer.iss in Inno Setup.
  2. Compile the script.
  3. The installer is written to packaging/Output/AppTrackr_Setup.exe.

Release Automation

The workflow at .github/workflows/release-windows.yml handles the full build and publish pipeline. Push a version tag to trigger it:

git tag v1.0.0
git push origin v1.0.0

The workflow builds the PyInstaller bundle, zips it as a portable archive, compiles the Inno Setup installer, and uploads both to the GitHub release.

Updates

Go to Settings > Updates, paste in the releases API URL, and click Check for Updates. Enable the startup check if you want it to run automatically.

For this repo, the URL is:

https://api.github.com/repos/H4ch1Net/AppTrackr/releases/latest

If AppTrackr finds a newer version it will offer to download and launch the installer for you.

Privacy

Window titles are off by default. If you enable title tracking in Settings, titles are hashed (SHA-256, truncated) before storage so the raw text is never saved. Mouse click counts are optional and stored as counts only, with no position or content data.

License

MIT

About

Lightweight Windows desktop app that tracks application usage with real-time analytics, a neon-styled UI, and optional gamification — all stored locally.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages