Skip to main content

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.

​
Installation

TypeSteps can be installed using Homebrew (recommended) or built from source using Xcode.

​
Requirements

Before installing, ensure your system meets these requirements:
  • macOS 13 or later
  • Apple Silicon or Intel Mac
  • For building from source: Xcode 16+ or compatible versions
The easiest way to install TypeSteps is using Homebrew.
1

Add the custom tap

Open Terminal and add the TypeSteps tap to Homebrew:
brew tap FALAK097/typesteps
2

Install the app

Install TypeSteps as a cask:
brew install --cask typesteps
Homebrew will download and install TypeSteps to your Applications folder.
3

Launch TypeSteps

Open TypeSteps from your Applications folder or use Spotlight:
open -a TypeSteps
On first launch, you’ll see the onboarding flow to grant necessary permissions.

​
Option 2: Build from source

If you prefer to build TypeSteps yourself or want to contribute to development, follow these steps.
1

Clone the repository

Clone the TypeSteps repository from GitHub:
git clone https://github.com/FALAK097/typesteps.git
cd typesteps
2

Open in Xcode

Open the Xcode project:
open typesteps.xcodeproj
Ensure you have Xcode 16 or a compatible version installed. You can download Xcode from the Mac App Store.
3

Build and run

In Xcode:
  1. Select your Mac as the build destination
  2. Click the Run button (or press Cmd + R)
  3. Xcode will build the app and launch it
For a release build, select Product > Archive from the menu.

​
Granting permissions

TypeSteps requires Accessibility permissions to track keystrokes system-wide. Without this permission, the app cannot function.
On first launch, TypeSteps will guide you through granting Accessibility permissions:
  1. The onboarding screen will explain why the permission is needed
  2. Click Open System Settings to be taken to the Accessibility settings
  3. In System Settings, navigate to Privacy & Security > Accessibility
  4. Toggle the switch next to TypeSteps to enable it
  5. Return to TypeSteps—it will automatically detect the permission and continue
If you don’t see TypeSteps in the Accessibility list, try clicking the + button and manually adding it from your Applications folder.

​
Data storage

All data is stored locally on your Mac using UserDefaults. TypeSteps tracks:
  • Daily character counts by date
  • Hourly and per-minute breakdowns
  • Per-application statistics
  • Project names (for supported IDEs)
  • Your WakaTime API key (if configured)
  • Daily goal settings
Characters are never transmitted over the internet unless you opt in to fetch developer stats via the WakaTime API.

​
Updating TypeSteps

​
Via Homebrew

Update TypeSteps to the latest version: 
brew upgrade --cask typesteps

​
From source

Pull the latest changes and rebuild: 
cd typesteps
git pull origin main
Then rebuild in Xcode.

​
Uninstalling

​
Via Homebrew

brew uninstall --cask typesteps

​
Manual removal

  1. Drag TypeSteps from Applications to Trash
  2. Remove stored data: 
    defaults delete com.falakgala.typesteps

​
Next steps

Quick start guide

Learn how to use TypeSteps and view your first stats

Build docs developers (and LLMs) love

Get started for freeTalk to us