1. timr-start(1)
  2. Timr Manual
  3. timr-start(1)


timr-start - Start a new Task/Track.


timr start [options] [id|task_id [track_id]]


Always removes all Tracks from the Stack and creates a new Track. If there is another current running Task this Task will be stopped and removed from the Stack.

Without any options this command always creates a new Task and starts a new Track for this Task. When providing a Task ID (SHA1 hex) of an existing Task, this Task will be continued. When also providing a Track ID (SHA1 hex) the same Track message will be taken to create a new Track for the Task.


--id str

Your ID to identify the Task. Not just to use the internal Task ID as task_id but also if you like to use your own ID. For example, when you want to sync Timr with JIRA and use the JIRA IDs to identify Timr Tasks instead of the Timr internal IDs. This can be any string, but MUST NOT include spaces. Use this String for task_id. This ID is also called 'Foreign ID' by Timr (internal).

-n, --name str

The name of the new Task. When providing a task_id this option will be ignored.

--description str

Longer description of the new Task. This should descibe the Task in general. Provide details by using --message option. When providing a task_id this option will be ignored.

-e, --est, --estimation time

Task Estimation. See timr-ftime(7).

-r, --hourly-rate float

Set the Hourly Rate.

--fr, --flat-rate, --flat

Has Task a Flat Rate?


-m, --message message

Details about what you have done. This overwrites the track_id argument.


Edit Track Message when providing a track_id. The EDITOR environment variable must be set.

-d, --date date

Track Start Date. Default: today. See timr-ftime(7).

-t, --time time

Track Start Time. This is useful when you forgot to run the Start command. Default: now. See timr-ftime(7).


-h, --help
Displays the help page.


task_id - Task ID as SHA1 hex string. It can be the full 40 characters or only the first 6. If not specified a new Task will be created.

track_id - Track ID as SHA1 hex string. It can be the full 40 characters or only the first 6. If specified a new Track with the same message will be created.


timr start
timr start --name my_task1
timr start --name 'Model 101' \
    --description 'Construct series 101.'
timr start --name my_task3 \
    --date 2017-01-02 --time 15:30 \
    --message 'Hello World'
timr start --name my_task4 --message 'Hello World'
timr start --name my_task5 --estimation 2h
timr start --message 'Hello World' abcd12
timr start --time 10:30 --message 'Hello World' abcd12
timr start --id T800




timr-stop(1), timr-push(1), timr-ftime(7)


This is part of timr(1).

  1. FOX21.at
  2. April 2017
  3. timr-start(1)