wizonesolutions / 2do-to-todoist

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

2Do to Todoist

This app adds items to Todoist using its REST API. It accepts a CSV exported from 2Do (File -> Export to CSV or Cmd-Shift-E) and adds those tasks to Todoist.

Installation/Usage

  1. Ensure you have PHP 7.0+.

  2. Clone this repository and run composer install.

  3. Check the CSV exported from 2Do and ensure it contains what you want. Note that to export all tasks, you must actively "select all" lists from the export dialog. You should only include Not Done tasks. (You might want to back up your Done tasks in a separate CSV.)

  4. Copy config-example.yml to config.yml and configure it according to the comments in the file. You can configure list/project mappings.

  5. Run php index.php /path/to/csv.csv where /path/to/2DoList.csv is the file path to your exported 2Do CSV. I recommend exporting "Not Done" tasks only.

How it works

  1. Tasks will get added to Todoist (or printed out to the terminal if you set simulate: true in config.yml). Tasks with 2Do Projects will be placed in projects named Project/Subproject. These will not be real subprojects due to current Todoist REST API limitations.

  2. Durations will be included in the task name (e.g. [20m]) and also as Todoist labels (e.g. @20_minutes). The former is always in minutes, since it is intended to integrate with Todoist's calendar integration.

  3. Negative priority is translated to an @negative_priority label.

  4. Locations get turned into labels.

  5. Starred tasks get labeled with @starred.

About Todoist Premium

  • The script tries to convert tags to labels even if you have not set premium: true in configuration, but I'm not sure what will happen. They probably just won't work.
  • Task comments are a Premium feature, so notes won't be imported. I could have included as much as possible in the task title, but that is limited to 2,048 characters, and I didn't want to deal with managing the size.
  • I'd be interested nonetheless in what happens if you try premium: true with a non-Premium account, so tell me in the issue queue.

Caveats

If you need something here, open a GitHub issue. If you have time and can implement it yourself, I will review and potentially pull requests. See Contribute below.

  • For best results, set 2Do to English prior to exporting. This is mainly to ensure that dates get exported in the expected format. Other languages MIGHT work since most things don't change, but I've only tested with English. If you export in another language, at least make sure your Todoist date format settings look like they match the format in the exported .csv file.

  • There is no undo, so I recommend using dry-run mode (simulate: true in config.yml) until you are satisfied with how things look.

  • Project names are used in the mapping, not project IDs. Those would practically require using the API to find out, anyway (it's possible other ways, but cumbersome). That means that the first-matched project name will be used. This is most likely the one highest up in the sort order in Todoist.

  • Make sure your timezone in Todoist is correct. 2Do exports using local time, so the tool imports using it as well.

  • Todoist has no start dates, so the tool adds a comment with the original start date. I figured this was better than adding a label, as I didn't want to flood my account with labels.

  • Repeating dates will be added to the task name. You have to edit the tasks in Todoist manually to fix them. (REST API limitations...). Note that you probably have to cut the repeating pattern (e.g. monthly), save the task, edit it again and paste it in. It doesn't seem to detect it properly otherwise.

  • Attachments and actions don't come through in the CSV and therefore not added to Todoist.

  • Note that Todoist has various limits, and the tool does not do anything specific to warn you if you will hit them.

  • The "after completion" and "until" features in repeating dates are not supported because they are not in the CSV. It would require decoding the database format.

  • Completed status and completion date are not synced. I only needed to move my open tasks.

  • If you're importing a lot of tasks, expect it to fail. Just remove the imported rows from your CSV and run it again. There's probably some unwritten rate limit for the beta API, but the library I'm using doesn't tell me why the error occurred.

Contribute

Main thing is just to follow PSR-1/PSR-2 coding standards as best you can. I'm not going to be too picky.

License

Note that this is licensed as AGPLv3 (or later). The main implication is that if you use it in a program served over a network (like a web application), the source code of that web application should be available to anyone who can access the web application.*

* I am not an attorney, and this is not intended as legal advice.


This application is not created by, affiliated with, or supported by Doist.

About

License:GNU Affero General Public License v3.0


Languages

Language:PHP 100.0%