Tool to sync Taskwarrior projects with Trello boards.
First for all you need configure some UDAs in Taskwarrior to store some Trello data. This is very, very, very important. If you dont have the UDAs configured before run TrelloWarrior you'll destroy your Taskwarrior tasks data.
To set UDAs in Taskwarrior simply edit
.taskrc and add the following
# UDAs uda.trelloid.type=string uda.trelloid.label=Trello ID uda.trellolistname.type=string uda.trellolistname.label=Trello List Name
The first UDA
trelloid is used to store the Trello Card ID and establish
an equivalence between Trello Cards and Taskwarrior Tasks. Note that you
never, never, never, never, (period), should edit this field.
The second UDA
trellolistname is used to determine the Trello List where
the Card/Task is stored. You can edit this field without problems to move
the task to another list.
Prepare the environment
The easy way
Simply create a Python 2/3 virtualenv and install via pip:
virtualenv trw . trw/bin/activate pip install trellowarrior
You can use your package system to install it, but the best way is to use a Python 2/3 virtualenv:
virtualenv trw . trw/bin/activate pip install tasklib pip install py-trello
Get the keys
TrelloWarrior access to Trello via API. You need generate an access token for it.
First go to: https://trello.com/app-key to get your API Key and API Secret.
Then call trellowarrior with the authenticate command :
trellowarrior.py -c path/to/your/configfile authenticate --api-key your_api_key --api-key-secret your_api_secret --name TrelloWarrior --expiration 30days
If the config file already exist, an error will be printed and the command will stop without doing anything.
You can set the
never. We recomend use
30days for tests and
never for daily use.
This return some like this.
Request Token: - oauth_token = 1c5ad394834dde42a7655437ab3e0060 - oauth_token_secret = dffc3a62622ef450028f685406bceacc Go to the following link in your browser: https://trello.com/1/OAuthAuthorizeToken?oauth_token=1c5ad334134dde46a8659437ab3e0069&scope=read,write&expiration=30days&name=trellowarrior Have you authorized me? (y/n)
You must visit the link to authorize the token. This gives you a pin like this.
You have granted access to your Trello information. To complete the process, please give this verification code: 17894a35a2f745c3a184cf8e4bb5f1f9
Respond yes, and insert the pin.
What is the PIN? 17894a35a2f745c3a184cf8e4bb5f1f9 Access Token: - oauth_token = 0469c6271416af6eae10123fdae0afc1135e9082bb0b5ba87b2f8a1db9d7f0b1 - oauth_token_secret = a978b159692cfc315377790669ac99a0 You may now access protected resources using the access tokens above.
The config file is now initialized with the needed configuration variables.
The TrelloWarrior config is very easy. There is a
sample file that you can modify to set with your data.
You can place the config file with
trellowarrior.py, in your home as
set the configuration file path with
To synchronize trello and task warrior, simply call trellowarrior with the sync command
You can also add a list of project(s) to synchronize :
trellowarrior.py sync project1 project2
DEFAULT section, it is mandatory to set your Trello API key and
token and, at least, one sync project.
The sync project corresponds to the following sections
that define the Taskwarrior project and Trello board equivalence.
taskwarrior_taskrc_locationOptional. Define where your taskrc file is located. Default:
taskwarrior_data_locationOptional. Define where your task data dir is located. Default:
trello_api_keyMANDATORY. Your Trello Api Key.
trello_api_secretMANDATORY. Your Trello Api Secret.
trello_tokenMANDATORY. Your Trello Token.
trello_token_secretMANDATORY. Your Trello Token Secret.
sync_projectsMANDATORY. Define what sections are loaded, separated by spaces.
The Project/Board sections are called from
sync_projects and define the
equivalence between Taskwarrior and Trello.
tw_project_nameMANDATORY. The name of project in Taskwarrior.
trello_board_nameMANDATORY. The name of Trello Board.
trello_todo_listOptional. The name of Trello list where new pending tasks are stored. Default:
trello_doing_listOptional. The name of Trello list for active tasks. Default:
trello_done_listOptional. The name of Trello list for done taks. Default:
|UDA: trelloid||Card ID|
|UDA: trellolistname||List Name|
|Due||Card Due Date|
The main objective of TaskWarrior is to be simple so it doesn't manage collisions. The sync strategy is last modified wins, this means that if you do a modification in Trello and later a modification in Taskwarrior, TrelloWarrior does the sync and keeps the Taskwarrior data, because it is the last touched.
You can have infinite lists in your Trello, but all of them are considered as pending. You only can have one doing list and one done list, but these lists can be configured.
If you have several boards with same name, TrelloWarrior always picks the first one.
For now, only syncs Title/Description, Due dates and Status.