UsagePilot

Track and Visualize Your Application Usage Patterns

Features • Installation • Usage • Contributing • License

UsagePilot is a privacy-first, local-only desktop application that helps you understand your digital habits by tracking application usage patterns.

• 🔍 Active Window Tracking - Automatically detects and tracks the focused application in real-time
• ⏸️ Smart Idle Detection - Pauses tracking when you're away (no mouse/keyboard activity)
• 🔒 Privacy-First - All data stored locally in SQLite. No cloud, no telemetry, no data collection
• 📊 Beautiful Dashboard - Visualize your daily usage with interactive charts and insights
• 📱 Apps Overview - Detailed breakdown of time spent per application with friendly names
• 🌓 Dark Mode - Sleek UI with automatic system theme detection and manual toggle
• 🚀 Autostart - Optional automatic launch on system startup
• 📈 Usage Analytics - Track productivity patterns and time distribution
• 💻 Native Performance - Built with Rust and Tauri for minimal resource usage

• Modern, responsive UI with Tailwind CSS
• Real-time updates without page refresh
• Intuitive navigation with sidebar
• Color-coded visualizations
• Friendly application names (e.g., "Google Chrome" instead of "chrome.exe")

Download the latest release for your platform from the Releases page.

Windows:

• Download .msi or .exe installer
• Run the installer and follow the prompts
• Launch UsagePilot from Start Menu

macOS:

• Download .dmg file (choose x64 for Intel or aarch64 for Apple Silicon)
• Open and drag to Applications
• Launch from Applications folder

Linux:

• Download .deb, .AppImage, or .rpm
• Install using your package manager or run AppImage directly

📖 Full Installation Guide with troubleshooting and platform-specific instructions

• Node.js 20+
• Rust 1.75+
• Platform-specific dependencies:
  • Windows: Microsoft C++ Build Tools
  • macOS: Xcode Command Line Tools
  • Linux: webkit2gtk, libappindicator3, librsvg2

    # Ubuntu/Debian
    sudo apt-get update
    sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf

1. Clone the repository:

   git clone https://github.com/yourusername/UsagePilot.git
   cd UsagePilot

2. Install dependencies:

   npm install

3. Run in development mode:

   npm run tauri dev

4. Build for production:

   npm run tauri build

   The installer will be in src-tauri/target/release/bundle/

1. Launch UsagePilot
2. Click "Start Tracking" to begin monitoring your application usage
3. Navigate through the sidebar:
   • Dashboard: Overview and charts
   • Applications: Detailed app breakdown
   • Settings: Theme, autostart, and preferences

• Duration: Total time an application was in focus
• Percentage: Relative time compared to other apps
• Today's Stats: Resets at midnight
• Idle Time: Automatically excluded from tracking

• Enable Autostart in Settings to track usage from system boot
• Toggle Dark Mode for comfortable viewing in different lighting
• All data is stored in usage_tracker.db in the app's data directory

• Rust - Systems programming language
• Tauri 2.0 - Desktop app framework
• SQLite with sqlx - Local database
• Windows API - Native window tracking

• React 19 - UI framework
• TypeScript - Type safety
• Tailwind CSS - Styling
• Zustand - State management
• Recharts - Data visualization
• Vite - Build tool

We love contributions! Whether you're fixing bugs, adding features, or improving documentation, all contributions are welcome.

• 🐛 Report bugs via GitHub Issues
• 💡 Suggest features with Feature Requests
• 📝 Improve documentation
• 🔧 Submit pull requests

1. Read our Contributing Guidelines
2. Check out our Code of Conduct
3. Fork the repository
4. Create a feature branch
5. Make your changes
6. Submit a pull request

See CONTRIBUTING.md for detailed instructions.

UsagePilot is licensed under the MIT License.

MIT License - Copyright (c) 2025 UsagePilot Contributors

UsagePilot includes an automatic updater that checks for new releases:

• Notifies you when a new version is available
• One-click download and installation
• Your data is preserved during updates

• Built with Tauri
• Icons and UI inspired by modern design principles
• Thanks to all contributors

• 📖 Documentation
• 📦 Installation Guide
• 🚀 Release Process
• 💬 Discussions
• 🐛 Issue Tracker