trackWork-0.4.0 is not a library.

trackWork

A powerful console-based time tracking application built with Rust featuring a beautiful terminal UI.

Features

Terminal UI: Clean, intuitive interface built with ratatui
Time Entry Management: Create, edit, delete, and reorder time entries
Navigation: Easy keyboard-driven navigation
Daily Views: View and track entries by date
Running Timers: Start entries without an end time and stop them later
Duration Tracking: Automatic calculation and display of time durations
Timeline Visualization: Vertical bar chart with fixed time resolution (1, 2, 5, or 10 minutes per row)
JIRA Integration: Link entries to JIRA issues and open them directly
Weekly Statistics: Aggregated time tracking by issue or description
Clipboard Integration: Copy durations and work logs
Persistent Storage: SQLite database for reliable data storage
Date Navigation: Browse entries across different days
What's New Screen: Shows new features on version updates

Installation

Build from source

cargo build --release

The binary will be available at target/release/trackWork

Run

cargo run --release

Usage

Keyboard Shortcuts

Normal Mode

n - Create new time entry
e - Edit selected entry
d - Delete selected entry (requires confirmation)
Shift+D - Force delete selected entry (no confirmation)
s - Stop running entry (or restart stopped entry)
Shift+S - Open settings
c - Copy selected entry duration to clipboard
l - Open JIRA issue in browser and copy duration
Shift+L - Toggle logged status for entry
o - Open worklog
↑/↓ - Navigate between entries
Ctrl+↑/↓ or Shift+↑/↓ - Reorder entries (move up/down)
←/→ - Change date (previous/next day)
Esc - Clear status messages
q - Quit application

Edit Mode

Type to enter data in the current field
Tab - Move to next field (Description → Start Time → End Time → Issue Key)
↑/↓ - Increment/decrement time in time fields
Enter - Save entry
Esc - Cancel and return to normal mode
Backspace - Delete character

Create Mode

Type to enter data in the current field
Tab - Move to next field (Description → Start Time → End Time → Issue Key)
↑/↓ - Navigate suggestion list (for descriptions/issue keys)
Enter - Save entry
Esc - Cancel and return to normal mode
Backspace - Delete character

Confirm Delete Mode

y - Confirm deletion
n or Esc - Cancel deletion

What's New Screen

Enter or Esc - Close and return to dashboard

Time Format

Enter times in 24-hour format: HH:MM (e.g., 09:30, 14:45)

Leave the end time empty to create a running timer.

Data Storage

The application stores all data in ~/.timetrack.db (SQLite database).

Project Structure

src/
├── main.rs       # Application entry point and event loop
├── app.rs        # Core application logic and state management
├── db.rs         # Database operations and SQLite interface
├── models.rs     # Data models (TimeEntry)
└── ui.rs         # Terminal UI rendering (separated from business logic)

Architecture

The application follows a clean separation of concerns:

UI Layer (ui.rs): Handles all rendering and display logic
App Layer (app.rs): Manages application state and user interactions
Data Layer (db.rs, models.rs): Database operations and data structures

This separation makes the codebase maintainable and testable.

Example Workflow

Launch the application
Press n to create a new entry
Enter description (e.g., "Client meeting")
Tab to start time, enter 09:00
Tab to end time, leave empty for running timer (or enter 10:30)
Tab to issue key field, optionally enter JIRA issue (e.g., "PROJ-123")
Press Enter to save
Use ↑/↓ to select entries
Press s to stop a running timer
Press l to open JIRA issue and copy duration
Press c to copy duration to clipboard
Use Ctrl+↑/↓ to reorder entries
Use ←/→ to view different days
Press Shift+S to configure settings (JIRA URL, colors)

Dependencies

ratatui - Terminal UI framework
crossterm - Cross-platform terminal manipulation
rusqlite - SQLite database interface
chrono - Date and time handling
anyhow - Error handling
dirs - Home directory detection

License

MIT

trackWork 0.4.0