sigma-z / simtt
Interactive Simple Command Line Time Tracker in PHP
Installs: 6
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 0
Open Issues: 0
Type:project
Requires
- php: >=8.1
- ext-json: *
- symfony/config: ^6.0
- symfony/console: ^6.0
- symfony/dependency-injection: ^6.0
- symfony/yaml: ^6.0
Requires (Dev)
- mikey179/vfsstream: ^1.6
- phpunit/phpunit: ^10
- roave/security-advisories: dev-master
- sensiolabs-de/deptrac-shim: ^1.0
- squizlabs/php_codesniffer: ^3.7
README
Read the full documentation
The project was inspired by badcrocodile/cltt.
Getting started
Start timer and Status
What have I done today?
What did I do yesterday?
Installation
$ composer create-project sigma-z/simtt
Linux/MacOS
$ ./simtt --version
Windows
$ php simtt --version
Implemented features
This is an early project state. At the moment the tool can do:
- start a timer
- update the start of a timer
- stop a timer
- update the stop of a timer
- status whether a timer is running or not
Limitations
- it is not possible to track times across days
Quick feature overview
Usage ./simtt -i to run the Simple Time Tracker in interactive mode.
You then can run a lot of commands directly by typing and pressing <enter>:
start [time<hhmm|hh:mm>] [task-name]
starts a timer at a given time for a named task. Note: time and task name can be left blank.
- implemented
start* [time<hhmm|hh:mm>] [task-name]
updates the start of last log entry. Note: time and task name can be left blank.
- implemented
stop [time<hhmm|hh:mm>] [task-name]
stops a timer at a given time for a named task. Note: time and task name can be left blank, a given task name will overwrite the task name given at the start.
- implemented
stop* [time<hhmm|hh:mm>] [task-name]
updates the stopping time of last log entry. Note: time and task name can be left blank.
- implemented
continue [time<hhmm|hh:mm>]
continues last stopped task for a given time.
- implemented
status
shows status whether a task is running, or not.
- implemented
now
shows current time (which can be different because of your configuration - see config precision)
- implemented
task[-offset] [<string>task-name]
updates a task text for a specified or currently running task. See also the documentation.
- implemented
comment[-offset] [<string>comment]
updates a comment for a specified or currently running task. See also the documentation.
- implemented
tasks
shows a list of the latest time tracked tasks
- implemented
log [range-selection<int>]
shows the latest log entries by range.
- implemented
day [sum]
shows the log entries of today. If "sum" is defined, it shows the log entries summarized.
- implemented
day-1 [sum] or yesterday [sum]
shows the log entries of yesterday. If "sum" is defined, it shows the log entries summarized.
- implemented
day-n [sum]
shows the log entries for n-days before today. If "sum" is defined, it shows the log entries summarized.
- implemented
You can do the same type of output for week and month.
- week implemented
- month implemented