---
title: "Trello"
date: 2018-05-10T10:44:35-07:00
draft: false
---

Displays all Trello cards on specified lists.

<img src="/imgs/modules/trello.png" width="640" height="188" alt="trello screenshot" />

## Source Code

```bash
wtf/trello/
```

## Required ENV Variables

<span class="caption">Key:</span> `WTF_TRELLO_APP_KEY` <br />
<span class="caption">Value:</span> Your Trello App Key. <br />
<span class="caption">Key:</span> `WTF_TRELLO_ACCESS_TOKEN` <br />
<span class="caption">Value:</span> Your Trello Access Token. <br />

_You can get your API key at: trello.com/app-key._

## Keyboard Commands

None.

## Configuration

### Single Trello List

```yaml
trello: 
  board: Main
  enabled: true
  list: "Todo"
  position: 
    height: 1
    left: 2
    top: 0
    width: 1
  refreshInterval: 3600
  username: myname
```

### Multiple Trello Lists

If you want to monitor multiple Trello lists, use the following
configuration (note the difference in `list`):

```yaml
trello: 
  board: Main
  enabled: true
  list: ["Todo", "Done"]
  position: 
    height: 1
    left: 2
    top: 0
    width: 1
  refreshInterval: 3600
  username: myname
```

### Attributes

`board` <br />
The name of the Trello board. <br />

`enabled` <br />
Determines whether or not this module is executed and if its data displayed onscreen. <br />
Values: `true`, `false`.

`list` <br />
The Trello lists to fetch cards from. <br />

`refreshInterval` <br />
How often, in seconds, this module will update its data. <br />
Values: A positive integer, `0..n`.

`username` <br />
Your Trello username. <br />

`position` <br />
Where in the grid this module's widget will be displayed. <br />