Branch	Status
master
dev

RTW - Rust Time Watcher

Command-line interface (CLI) time tracker.

This project is for educational purpose only. It is a partial Rust implementation of Timewarrior.

For a stable feature-rich CLI time tracker, please use Timewarrior: https://timewarrior.net/.

Development

Development occurs on dev, releases are made on master branch.

Install

Supported OS: Linux.

Cargo

cargo install rtw

Build From Source

Clone and build from source:

git clone https://github.com/PicoJr/rtw.git
cd rtw
cargo build --release

Changelog

Please see the CHANGELOG for a release history.

Basic Usage

Start tracking an activity

Example:

rtw start "learn rust"

Example output:

Tracking learn rust
Started  2019-12-25T19:43:00

Display current activity

rtw

Example output:

Tracking learn rust
Total    01:15:00

Stop current activity

rtw stop

Example output:

Recorded learn rust
Started 2019-12-25T19:43:00
Ended   2019-12-25T21:00:00
Total   01:17:000

Display the day's activity summary

rtw summary

Example output:

read the doc 2019-12-25T11:49:30 2019-12-25T11:53:36 00:04:246
eat cookies  2019-12-25T12:08:49 2019-12-25T12:12:14 00:03:204

More?

For further details see Full Usage.

Implementation

RTW relies on json files for persistence.

Default location is the home (~) directory.

~/.rtw.json  # stores current activity
~/.rtwh.json # stores finished activity

there is currently no file locking mechanism: running several rtw commands at the same time may lead to undefined behavior.