Trello

You can import tasks from Trello cards using the trello service name.

Options

trello.api_key

Your Trello API key, available from https://trello.com/app-key

trello.token

Trello token, see below for how to get it.

trello.include_boards

The list of board to include. If omitted, bugwarrior will use all boards the authenticated user is a member of. This can be either the board ids of the board “short links”. The latter is the easiest option as it is part of the board URL: in your browser, navigate to the board you want to pull cards from and look at the URL, it should be something like https://trello.com/b/xxxxxxxx/myboard: copy the part between /b/ and the next / in the trello.include_boards field.

../_images/trello_url.png
trello.include_lists

If set, only pull cards from lists whose name is present in trello.include_lists.

trello.exclude_lists

If set, skip cards from lists whose name is present in trello.exclude_lists.

trello.import_labels_as_tags

A boolean that indicates whether the Trello labels should be imported as tags in taskwarrior. (Defaults to false.)

trello.label_template

Template used to convert Trello labels to taskwarrior tags. See Field Templates for more details regarding how templates are processed. The default value is {{label|replace(' ', '_')}}.

Example Service

Here’s an example of a Trello target:

[my_project]
service = trello
trello.api_key = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
trello.token = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

The above example is the minimum required to import tasks from Trello. This will import every card from all the user’s boards.

Here’s an example with more options:

[my_project]
service = trello
trello.api_key = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
trello.token = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
trello.include_boards = AaBbCcDd, WwXxYyZz
trello.include_lists = Todo, Doing
trello.exclude_lists = Done
trello.only_if_assigned = someuser
trello.import_labels_as_tags = true

In this case, bugwarrior will only import cards from the specified boards if they belong to the right lists..

Feel free to use any of the configuration options described in Common Service Configuration Options or described in Service Features below.

Service Features

Include and Exclude Certain Lists

You may want to pull cards from only a subset of the open lists in your board. To do that, you can use the trello.include_lists and trello.exclude_lists options.

For example, if you would like to only pull-in cards from your Todo and Doing lists, you could add this line to your service configuration:

trello.include_lists = Todo, Doing

Import Labels as Tags

Trello allows you to attach labels to cards; to use those labels as tags, you can use the trello.import_labels_as_tags option:

trello.import_labels_as_tags = True

Also, if you would like to control how these labels are created, you can specify a template used for converting the trello label into a Taskwarrior tag.

For example, to prefix all incoming labels with the string ‘trello‘ (perhaps to differentiate them from any existing tags you might have), you could add the following configuration option:

trello.label_template = trello_{{label}}

In addition to the context variable {{label}}, you also have access to all fields on the Taskwarrior task if needed.

Note

See Field Templates for more details regarding how templates are processed. The default value is {{label|upper|replace(' ', '_')}}.

Provided UDA Fields

Field Name Description Type
trelloboard Board name Text (string)
trellocard Card name Text (string)
trellocardid Card ID Text (string)
trellolist List name Text (string)
trelloshortlink Short Link Text (string)
trelloshorturl Short URL Text (string)
trellourl Full URL Text (string)