# time.txt

Simple plain-text time tracking.

The Python script `tx` provides short-hands for accessing and reading a `time.txt` file, as described below.

## Installation

For testing, you can just run `tx` in this directory using `./tx`.

If you want to be able to use it anywhere, run `install.sh`. The `tx` command should then be available in any folder.

## Usage

Create a new `time.txt` file at the current location: `tx create`

Add a time entry: `tx add 01:00 Totally productive work`

View the total unbilled time: `tx total` or simply `tx`

Remove time which was billed: `tx bill 05:00 Fee note for this month`

## Format

The `time.txt` file is written in the following format:

```
2020-08-12 01:00 Work on Task 1
2020-08-12 03:00 Work on Task 2
2020-08-16 05:00 Finish Task 2
2020-08-31 -08:00 Fee note for August
```

With this file, the total amount of (unbilled) hours is 01:00.

All `tx` commands are simply short-hands for accessing and reading this file comfortably. It can be edited manually at any time.