trax-tui 0.8.0

TrackingTime TUI

trax-tui

A TUI for TrackingTime.

Installation

pipx install trax-tui

Requires a keyring backend (e.g., GNOME Keyring, macOS Keychain, Windows Credential Manager).

Setup

tt login

Enter your TrackingTime email and App Password. You can create an App Password in your TrackingTime settings under Apps & Integrations. Credentials are stored securely in your system keyring.

Usage

tt

Opens an interactive terminal interface for logging time:

• Navigation - Ctrl+J/Ctrl+K to cycle focus between elements
• Week calendar - h/l (days), j/k (weeks), g (today)
• Entries list - j/k to scroll entries
• Global - h/l (move day), y (yank event), d (delete event), p (submit form), q (quit)

Single keys type normally when an input is focused. Ctrl+J/Ctrl+K always works.

Duration format

The duration field accepts 2h30m, 90m, etc. You can also specify a start time with @:

• 2h — logs 2 hours starting after the last event (or 9am if none)
• 2h@1pm — logs 2 hours starting at 1:00 PM
• 1h30m@14:30 — logs 1h30m starting at 2:30 PM