Trello Setup

Credentials

Install the org-trello-consumer-key and the read-write org-trello-access-token to permit org-trello to access your trello boards.

C-c o i or M-x org-trello-install-key-and-token

First, ensure that the web browser emacs is configured to use is started and that you are logged in Trello.

This command will:

ask for an account name which must be your trello login. Check https://trello.com/your-user-login-and-not-your-email where your-user-login-and-not-your-email is your user login and not the email you used to subscribe to trello, otherwise, you will have sync issues.
open your browser for you to select and copy your org-trello-consumer-key (Developer API Keys / key entry) and paste it inside emacs’ minibuffer (hit RET when done).

open a second tab to ask you to authorize org-trello to work in your name on your account

If you are not ok with this, hit Deny. It’s ok, you just won’t be able to use org-trello.
Otherwise, hit Allow, this will then present you a form with the read/write org-trello-access-token, select and copy it then paste it inside emacs’ minibuffer and hit RET.

Note: This command, if accepted, results in a file stored only in your disk in ~/.emacs.d/.trello/.el</kbd> (this path may vary depending on **user-emacs-directory**).

This file contains your credentials and will be used to identify you when requesting trello.

(setq org-trello-consumer-key "abc...")  ;; 32 characters string
(setq org-trello-access-token "def...")  ;; 64 characters string

Remark: This routine needs to be done once, until you revoke the token.

Connect org-mode buffer to board

For each org-mode file, you need to connect your org-mode file with a trello board.

C-c o I or M-x org-trello-install-board-metadata

This will:

ask you for the accounts you want to use (if you have multiple ones, otherwise, select the only one and pass to the next step silently)
present you with a list of boards for the selected account. Select the one you want and hit enter.
edit your org-mode file to add the properties needed.

Remarks: This needs to be done once for each org-mode file you want to sync with a trello board.

Create a board

You can avoid the previous step and create directly a board from your org-mode file.

C-c o b or M-x org-trello-create-board-and-install-metadata

This will:

ask you for the accounts you want to use (if you have multiple ones, otherwise, select the only one and pass to the next step silently)
create the list from the keywords configured in your org-mode (cf. org-todo-keywords)

Migrations

migration guide