Due to the fact that StatusBoard doesn't run on modern iOS and The Dash has been shut down, this repo and gem are being archived.

##What is Flareboard?

Flareboard is the way to get your CloudFlare stats to display in StatusBoard or The Dash. It has been designed to be very easy to install and use. It requires no third-party gems, and can be run on any version of ruby from 1.9.x to 2.2.x

Add your credentials and sites to flareboard, and it will hit the CloudFlare API to grab your stats and convert them into the JSON that Statusboard uses for graphing. You can drop the resulting file into a dropbox folder or host it on a web server. Unless you are paying for a CloudFlare Pro account, your stats will only update every 24 hours, so it's no use running flareboard more often than that.

Note: It is no longer compatible with Ruby 1.8, as that version is no longer being supported upstream. Please upgrade.

Simply run gem install flareboard

Copy the file bin/flareboard onto your computer. Put it either in a bin directory in your path or somewhere else.

There are three ways of configuring the script. Via the command-line arguments documented in the Usage section, via a config file (~/.flareboard.rc), or by editing the script directly. In order of priority (highest to lowest), it will use command-line options, the config file, and then the hard-coded config hash in the script.

It is highly recommended to use a config file, as passing your API token on the command-line is a security risk, and modifying the script itself will make upgrades manual and laborious.

The title that will show up on your status board

Your Cloudflare token - available via their website at https://www.cloudflare.com/my-account

The email you have registered with cloudflare. NOT your username!

Interval Values - see https://www.cloudflare.com/docs/client-api.html for latest.

20-40 only update once a day - it is no use polling more often than that
20 = Past 30 days
30 = Past 7 days
40 = Past day
!!! Anything higher than this requires a paid CloudFlare account !!!
!!! This also enables greater than daily updates !!!
100 = 24 hours ago
110 = 12 hours ago
120 = 6 hours ago

Sites have a site specific title, a URL, and a color for the graph. Colors: yellow, green, red, purple, blue, mediumGray, pink, aqua, orange, lightGray

Here is an example config file, using the same data as the example hash.

---
:token: XXXXXXX
:email: user@example.com
:sites:
- :title: 'Should I Use That In Prod'
  :url:   'shouldiusethatinprod.com'
  :color: 'red'
- :title: "It's Not Rocket Science"
  :url:   'itsnotrocketscience.info'
  :color: 'purple'

Usage: flareboard [options]
    -f, --file FILE                  Where to write the JSON output
                                     Defaults to STDOUT
    -t, --token TOKEN                Your CloudFlare API token
    -e, --email EMAIL                Your CloudFlare email address
    -i, --interval INTERVAL          CloudFlare history interval
                                     Defaults to 40
        --title TITLE                Title of the status board
                                     Defaults to 'Cloudflare - Pageviews'

If no file is given, flareboard will write to standard out.