README.md

August 4, 2026 · View on GitHub

takatime

TakaTime

The Open Source, Self-Hosted WakaTime Alternative.
"Time is what we want most, but what we use worst."


GitHub Stars Total Visits License Total Downloads

Works With

Neovim VS Code JetBrains Antigravity

Available On

VS Code Marketplace Open VSX JetBrains Marketplace

Go JavaScript Kotlin Lua

MongoDB Docker

TakaTime Weekly Report

Time Stats
Languages Projects
Languages Projects
Tech Stack

Generated automatically by TakaTime

Official Documentation & Setup

Click here to visit the TakaTime Wiki for complete installation guides, database setup (BYODB), dashboard commands, and theme customization.

Visual Theme Generator

Tired of manually configuring command-line flags? Use the Interactive TakaTime Generator to visually customize your stats card, preview themes in real-time, and instantly copy the exact Markdown snippet you need for your GitHub Profile.

Interactive Terminal Dashboard

TakaTime includes a fully interactive, offline-first terminal dashboard directly inside your editor. View your coding stats, language breakdowns, and project times without ever leaving your workflow or opening a browser.

output

Features

  • Non-Blocking Architecture: Engineered in Go with asynchronous concurrency. Data synchronization occurs entirely in the background, ensuring zero latency impact on your editor's performance.
  • Bring Your Own Database (BYODB): Data is persisted exclusively to your personal MongoDB instance. This ensures complete data ownership with no third-party tracking or subscription fees.
  • Granular Telemetry: Intelligently tracks and categorizes development activity by project, programming language, and file type without requiring manual configuration.
  • GitHub Profile Integration: Automatically generate high-resolution statistical charts for your GitHub Profile README via GitHub Actions.

Themes

TakaTime includes 18 built-in color themes. Browse the full visual gallery — including Terminal Dashboard and Web Generator previews for each theme — in THEMES.md.

Editor Compatibility

TakaTime is cross-platform and editor-agnostic. All plugins share the same core Go binaries for a consistent experience.

Feature Neovim VS Code Antigravity JetBrains OS Support
Background Sync ✓ Supported ✓ Supported ✓ Supported ✓ Supported Win, Mac, Linux
Terminal Dashboard ✓ Supported ✓ Supported ✓ Supported ✓ Supported Win, Mac, Linux
Profile Stats ✓ Supported ✓ Supported ✓ Supported ✓ Supported Win, Mac, Linux
Privacy Controls ✓ Supported ⚙ Planned ⚙ Planned ⚙ Planned All OS

Architecture

High-Level Architecture Zero-Latency Flow
Sequence Diagram High Level Architecture Diagram

Contributors & Community

We welcome pull requests! Whether you want to add support for a new IDE or a new TUI theme, check out our Contribution Guidelines.

Contributors

License: MIT License. See LICENSE for details.