> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/FALAK097/typesteps/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> TypeSteps is a privacy-focused macOS app that passively tracks your typing activity system-wide, giving you insights into your daily keyboard usage.

# TypeSteps

TypeSteps is a privacy-focused macOS application that passively tracks the number of characters you type each day system-wide. Think of it as a step counter—but for your keyboard!

<Frame>
  <img src="https://github.com/user-attachments/assets/acdebf0f-9b74-428c-af20-4582368264a7" alt="TypeSteps Dashboard" />
</Frame>

## Why TypeSteps?

Whether you're a developer, writer, or knowledge worker, TypeSteps helps you understand your typing patterns and productivity rhythms without compromising your privacy. Every keystroke is counted locally on your device—no data ever leaves your Mac.

<CardGroup cols={2}>
  <Card title="Get started" icon="rocket" href="/quickstart">
    Install TypeSteps and see your first stats in under 5 minutes
  </Card>

  <Card title="Installation" icon="download" href="/installation">
    Choose between Homebrew or building from source
  </Card>

  <Card title="Privacy first" icon="shield-check">
    Never records actual characters—only increments a counter stored locally
  </Card>

  <Card title="Rich insights" icon="chart-line">
    View daily, weekly, and monthly trends with beautiful visualizations
  </Card>
</CardGroup>

## Key features

### System-wide keystroke counting

TypeSteps runs quietly in the background, counting letters, numbers, punctuation, and whitespace typed across all apps. It does not track modifier keys alone (Shift, Ctrl, Cmd, Option), function keys, or keyboard shortcuts.

### Privacy first

Never records or stores actual typed characters. It only increments a numeric counter, which is saved locally on your device using `UserDefaults`. Your typing data never leaves your Mac.

### Historical insights

View your typing metrics with:

* **Hourly breakdown** for the current day
* **Daily trends** over the past week
* **Monthly statistics** for the past six months
* **Activity heatmap** showing your consistency throughout the year

### Menu bar integration

A lightweight presence in your menu bar shows your current count at a glance. Quickly access:

* Today's typing count
* Weekly and monthly totals
* Pause/resume tracking
* Dashboard window

### Application tracking

See which apps you type in most, with automatic categorization:

* Code (Xcode, VS Code, Terminal)
* Communication (Slack, Discord, Mail)
* Creation (Notion, Obsidian, Figma)
* Browsing (Safari, Chrome, Arc)
* Utility (System apps)

### Gamified milestones

Track your progress toward fun milestones like:

* Keyboard Sprint (10,000 characters)
* The Tower - Burj Khalifa (50,000 characters)
* City Explorer - Central Park (250,000 characters)
* Mountain King - Mt. Everest (1,000,000 characters)
* Channel Swimmer - English Channel (5,000,000 characters)
* Grand Tour - Across India (50,000,000 characters)

### WakaTime sync (optional)

Link your WakaTime API key to see developer-specific metrics:

* **Active time**: Total time spent coding
* **Density**: Keystrokes per minute to measure focus

## Requirements

<Note>
  TypeSteps requires **macOS 13 or later** and runs on both Apple Silicon and Intel Macs.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Install TypeSteps" icon="download" href="/installation">
    Get TypeSteps installed via Homebrew or build from source
  </Card>

  <Card title="Quick start guide" icon="play" href="/quickstart">
    Launch the app, grant permissions, and view your first stats
  </Card>
</CardGroup>