This documentation is based on TooDo v2.3.6.

Account settings

For the synchronization to work, you first need to have either a RTM or Toodledo account: note that no pro account is required. If this is the case, you need to set up once for good TooDo with your account credentials. On that purpose, go to the home screen, then select the icon corresponding to the service you want to be synchronized with.

On the newly displayed screen, go to the "Credentials" tab, and then read the instructions:

• for RTM, you need to fulfil the "RTM Account Id" text field, and then click the "Get Token" button: this will display the Android browser at a page which asks you to authenticate with your regular RTM account. Once done in the browser, come back to TooDo. The "Auth Token" field must have been updated
• for Toodledo, you need to fulfil the "e-mail" and "Password" text field, and then click the "Get User Id" button. This will update the "User Id" field, which TooDo needs in order to run the synchronization

Synchronization is optimized!

A foreword about the synchronization: it has been much optimized, and only the tasks that have been remotely modified and the local TooDo to-dos that have been modified since the last synchronization will be taken into account. This is why it is important that your Android device time and date be accurate.

While this is in most cases a good strategy, because it minimises the synchronization duration, the memory used, and the network bandwidth, it may have unexpected side-effects when changing the "Clear completed to-dos" option to false: please read the "Indicate whether to keep completed to-dos" paragraph on that purpose. We refer to the term "full synchronization" in opposition to "optimized synchronization": a full synchronization on a category will work with all remote tasks and local to-dos pertaining to that category, whether completed or not.

Select the right lists/folders

Once the credentials are properly set, please switch to the "General" tab. The lists/folders list should be empty, and since TooDo offers the opportunity to filter the lists (RTM) / folders (Toodledo), you need to manually retrieve them from your service account.

1. On that purpose, please click the "Update List" button, which will fetch your service lists/folders
2. Once done, please check/uncheck the lists/folders you want to have synchronized on this same screen

When changing the value of the previous check boxes, TooDo will run a full synchronization againt that category next time.

Indicate whether to keep complete to-dos

In the "Settings" screen, "Synchronization" section, there is a check-box named "Clear completed to-dos" (unchecked, by default), which controls whether the to-dos that have been marked as complete should be kept in TooDo when synchronizing. When it is checked, all to-dos which are synchronized will be deleted from TooDo either if they have been completed in TooDo or through the service web interface: however, this will not delete the corresponding task on the remote service. This option is there to prevent from too many to-dos to be present in the TooDo's database.

Warning: even when turning this option on, and running a new synchronization will not retrieve remotely completed tasks unless they have been modified remotely from the time you changed that option. This is due to the fact that the synchronization is optimized, and only copes with recently modified remote tasks and to-dos. For a full synchronization to be run for a category, please uncheck and check the corresponding box on the service settings screen, and run a synchronization.

Select the service for synchronization

Last, in order to have your service synchronized, please go to the "Settings" screen, and in the "Synchronization" section, check the box that corresponds to the remote service you have just parametrized. Next time you click on the "Synchronization" button, TooDo will synchronize with your tasks management service.

Synchronize!

For the synchronization to run, you have two options:

1. either from the "Settings" screen: in the "Synchronization" section, there is a "Setup" button for both RTM and Toodledo. When clicking on it, a new RTM/Toodledo screen is displayed: click on the "Synchronize" button on the "General" tab. At the end of the synchronization, a dialog box is displayed, which provides some details about the result;
2. or from the to-dos, categories, contexts list screens, or the main screen, click the menu button, and hit the "Synchronization" icon: this will run a synchronization in the background. At the end of the synchronization, an Android notification appears, which proposes to open a dedicated screen that shows the result.

When synchronizing, TooDo will create remotely the RTM list / Toodledo folder corresponding to newly created TooDo categories that have been marked at creation time via the "Create RTM/Toodledo at next synchronization?" check-box. Reversely, of a TooDo category has been deleted since the previous synchronization, its corresponding RTM list / Toodledo folder will be deleted.

Conflicts

In the result, the number of conflicts encountered is displayed: a conflict occurs when a to-do has been both modificated in the remote service and in TooDo since the last synchronization. Whe this occurs, no modification is done niether on TooDo nor on the remote service side, in order to avoid mistakes.

Synchronization completion notification

If you do not want to have an Android notification everytime the synchronization has run, you can uncheck the "Show results when OK" box available in the "Settings" screen, "Synchronization" section.

Automatic synchronization

The synchronization can be turned to be automatic. On that purpose, go to the "Settings" screen, section "Synchronization". The "Automatic", "Leaving synchro" and "Interval" controls enable to customize how this runs. This is still beta and will be documented onced stabilized. Here are the explanations for those settings:

• Automatic: when uncheked, this feature is disabled
• Leaving synchro: when leaving TooDo, if the end-user has performed some modifications during his session, a synchronization will be run
• Interval: expresses an amount of time in minutes. When TooDo is opened, it looks whether the time gap between the latest time you left TooDo and the current time exceeds that aount of time: if this the case, a synchronization will be run, and only in that case. The shorter this amount of time is, the more synchronizations will be run

Synchronization progress status and logs screen

When TooDo is synchronizing, an ongoing notification is displayed on the Android top bar: if you expand the notification banner and click on the ongoing entry related to TooDo, a screen is displayed, which displays the synchronization current progress status: the current stage is displayed, and a more detailed status is also displayed.

Moreover, all those progress status messages are collapsed in a bottom log on that same screen.

When the synchronization is completed, the logs are still displayed, and the result of the synchronization is displayed.