Skip to content
An easy to use self-hosted SCRUM burndown chart for Trello boards. (Docker or binary)
Branch: master
Clone or download
Latest commit 33ff4fd Apr 25, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets Add http.readOnly config. Apr 20, 2019
cmd Add http.readOnly config. Apr 20, 2019
pkg Add http.readOnly config. Apr 20, 2019
screenshots Update view screenshot. Nov 29, 2016
.gitignore Change position to float64. May 10, 2018
Dockerfile chore: Use local sources for docker build Mar 8, 2019
LICENSE Initial commit Nov 11, 2016
Makefile Restructure all files. May 10, 2018
README.md typo Apr 25, 2019
config.yaml.default Add http.readOnly config. Apr 20, 2019

README.md

trello-burndown

Go Report Card

An easy to use SCRUM burndown chart for Trello boards.

Getting started

Get quickly up and runnning with the docker image or binary.

Or compile the binary or docker image from source.

How it works

  • The points must be present in the title between parenthesis like so: (2) Add login page
  • The last column of the board is where finished cards are found.
  • Weekends are ignored. Points that were completed in the weekend are appointed to the next monday.

Screenshots

Viewing a burndown chart

view

Adding a trello board

add

Index page with table of trello boards

index

Installation

Obtain trello tokens

  1. Login to trello
  2. Generate a Developer API key
  3. Generate a token by visiting the following URL: https://trello.com/1/authorize?name=trello-burndown&expiration=never&response_type=token&key=DEVELOPER_API_KEY. Replace "DEVELOPER_API_KEY" with the key you generated in the previous step.
  4. Write both the Developer API key and the generated token down, you will need these to configure the application.

Docker: Setup & Running

  1. Create a new directory to store the configuration and SQLite3 database.

    λ mkdir trello-burndown && cd trello-burndown
    
  2. Create a file named config.yaml in the same directory, copy the contents from the default here.

  3. Edit the configuration file with your favorite editor and set the developer api key and generated token you wrote down earlier.

  4. Run it! (Check docker hub for available versions)

    λ docker run -d -p 8080:8080 --volume $(pwd):/root:Z swordbeta/trello-burndown:latest
    

    Note 1: The config file must be present in the /root directory inside the docker container.

    Note 2: :Z is required on systems with SELinux set to enforcing.

Binary: Setup & Running

  1. Download the latest release from here.

  2. Create a file named config.yaml in the same directory, copy the contents from the default here.

  3. Edit the configuration file with your favorite editor and set the developer api key and generated token you wrote down earlier.

  4. Run it! You could run this as a daemon with upstart/supervisord/systemd/etc.

    λ ./trello-burndown
    

Compile from source

First clone the repository:

 λ git clone https://github.com/mtricht/trello-burndown.git
 λ cd trello-burndown

To build the docker image:

 λ make docker

Or a binary targeting linux/amd64:

 λ make build
You can’t perform that action at this time.