Docs
Powered by

# Focusd 

   __                           _ 
  / _|                         | |
 | |_ ___   ___ _   _ ___  ____| |
 |  _/ _ \ / __| | | / __|/ _  | |
 | || (_) | (__| |_| \__ \ (_| |_|
 |_| \___/ \___|\__,_|___/\____(_)

Privacy-First Digital Wellbeing for Windows

Track your screen time. Own your data. No cloud required.

License Release Build Status Website
Stars Downloads Repo Size

GitHub: https://github.com/0xarchit/Focusd
Live Project: https://focusd.0xarchit.is-a.dev

# Why Focusd?

Every productivity tracker on the market uploads your data to their servers. Focusd doesn't. Your usage data stays on your machine, stored in a local SQLite database that you fully control.

App Installer / Disk Size RAM Usage (Idle) Tech Stack
StayFree (Windows) ~164 MB 150MB - 400MB likely Electron / UWP
Toggl Track ~100 MB 200MB - 500MB Electron (Chromium bundled)
RescueTime (Classic) ~25 MB 20 - 50 MB Native C++ / Qt
Focusd <11 MB ~4 - 10 MB Go (Native Syscalls)

# Quick Start

PowerShell (Recommended):

iwr "https://github.com/0xarchit/focusd/releases/latest/download/focusd.exe" -OutFile focusd.exe; ./focusd.exe init

Command Prompt:

curl -L -o focusd.exe "https://github.com/0xarchit/focusd/releases/latest/download/focusd.exe" && focusd.exe init

# Features

# Usage Dashboard

View daily and historical screen time with a beautiful terminal UI.

focusd stats

# Focus Sessions

Built-in Pomodoro timer with completion notifications.

focusd focus 25

# Browser Tracking

Tracks time spent per browser tab (by page title, not URL for privacy).

  • View in focusd stats → Browser Usage
  • Add custom browsers: focusd browser add <exe_name>

# Smart App Grouping (Experimental)

Automatically groups related browser tabs (e.g., all YouTube videos under "YouTube").

  • 80+ supported sites (YouTube, GitHub, Reddit, Discord, LeetCode, etc.)
  • Shows parent category with sub-entries
  • Note: This feature is under active development. Some titles may not group correctly.

# App Limits

Set daily time limits for distracting applications.

focusd limit

# Background Daemon

Silent background process with minimal resource usage (~5MB RAM, ~0% CPU).

# Commands

Command Description
focusd Interactive menu
focusd stats Open usage dashboard
focusd focus <mins> Start focus timer
focusd limit Configure app limits
focusd browser Add/remove custom browsers
focusd start/stop Control background service
focusd update Check for updates
focusd uninstall Remove all data

# Privacy

  • No telemetry. Zero network requests except for update checks.
  • No cloud. All data stored locally in %APPDATA%\focusd\focusd.db.
  • Open database. Standard SQLite—query it yourself with any SQL tool.
  • Open source. Audit the code anytime.

# Building from Source 

git clone https://github.com/0xarchit/Focusd.git
cd Focusd
go build -ldflags="-s -w" -trimpath -o focusd.exe ./cmd/focusd

Requirements: Go 1.21+