37 lines
1.0 KiB
Markdown
37 lines
1.0 KiB
Markdown
# 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.
|