Todo.txt—Recurring tasks

Update:

Task recurrence tags have changed starting with version v.8.33.8 (Chrome extension) and v.2020.0601.4.2.12 for Android app.


Task recurrence is available as an experimental feature in the Todo.txt for Android and the Todo.txt for Chrome apps.

The apps implement recurrence based on the syntax used in the topydo app.

Tag used for recurrence is ‘rec:‘. It accepts values as numbers followed with a period indicator, e.g. ‘rec:1w‘ to repeat after one week. Accepted period indicators are:

  • d‘ for days
  • w‘ for weeks
  • m‘ for months
  • y‘ for years

By default, task recurrence is based on completion date. Alternatively, the recurrence may be preceded by ‘+‘ to indicate that the task should repeat from due date.

Recurrence is applied when a task is completed. When a task is marked completed in one of these apps, the app creates a new task with relevant dates delayed by the recurrence period.

In the Android app, you may also add or change recurrence using the recurrence button on the edit task screen. In the Chrome extension, recurrence input fields are displayed on add task screen when recurrence is enabled in settings.

Examples

Normal recurrence (repeat from completion date)

Say, we have a weekly repeating task in the app:

(B) 2020-02-29 Charge smartwatch +personal due:2020-03-05 rec:1w

Creation date: 29 Feb
Due date: 2 Mar
Repeat: once a week, from completion date

Upon completion, this task is replaced by two tasks:

(B) 2020-03-01 Charge smartwatch +personal due:2020-03-08 rec:1w
x 2020-03-01 2020-02-29 Charge smartwatch +personal due:2020-03-05 rec:1w pri:B
  • The original task, with creation date on 29 Feb is marked as completed.
  • A new task is created with
    • creation date set to the day previous task was completed,
    • due date set to ‘one week’ from the date of completion.

Strict recurrence (repeat from due date)

Say, we have a monthly repeating task in the app:

(B) 2020-01-01 Update user numbers in spreadsheets +apps due:2020-01-05 t:2020-01-03 rec:+1m

Creation date: 1 Jan
Due date: 5 Jan
Repeats: once a month

Upon completion, this task is replaced by two tasks:

(B) 2020-02-01 Update user numbers in spreadsheets +apps due:2020-02-05 t:2020-02-03 rec:+1m
x 2020-02-03 2020-01-01 Update user numbers in spreadsheets +apps due:2020-01-05 rec:+1m pri:B
  • The original task, with creation date on Jan 1st is marked as completed.
  • A new task is created with creation and due dates ‘one month’ after the respective dates of the original task.

Searching

Search for recurring tasks using tag: ‘is:rec‘. The tag can also be negated to list non-repeating tasks: ‘-is:rec‘.

Known issues

  1. If a recurring task is changed back to pending after marking complete, the next recurring copy stays in the task list.
  2. Using ‘undo‘ after marking a recurring task complete also leaves the recurring copy of the task in the list.
  3. Recurring tasks marked complete in another app will not have a recurring copy created. Unless the other app, e.g. topydo, has also implemented recurrence and creates a copy.

Implementation of recurrence is still in early stages. Please use the in-app feedback form to share feedback about this feature.