Big Bucket Software you like to use
Status Board and Campaign Monitor
May 6th, 2013

If you’ve visited the promo page for Big Bucket’s upcoming game, Space Age, you’ll notice that it’s possible to add your email address to our mailing list. To manage this mailing list, I’m using Campaign Monitor.

I recently purchased Panic‘s Status Board app. Status Board is a bit like Dashboard, but for iPad. It comes with a few useful widgets (Panels) built in, and it also lets you write your own.

Here’s a Panel I wrote that displays the number of people who have subscribed to a Campaign Monitor list.

What’s Involved

The solution consists of 3 parts:

  1. A Ruby script that accesses the Campaign Monitor API.
  2. A Launch Agent that periodically runs that Ruby script.
  3. Some HTML/JS for presenting the output of that script in Status Board.

Getting Started

Here’s a download containing everything you’re going to need.

First, install the createsend gem:

sudo gem install createsend

Next, move campaignmonitor.rb and campaignmonitor.html into ~/Dropbox/Public/statusboard. And ensure that the script is executable:

chmod +x ~/Dropbox/Public/statusboard/campaignmonitor.rb

The Launch Agent

Next, move com.bigbucketsoftware.campaignmonitor.plist into ~/Library/LaunchAgents.

You’ll need to configure the LaunchAgent/Script to point to your particular Campaign Monitor list, so open com.bigbucketsoftware.campaignmonitor.plist in your favorite text editor and replace API KEY GOES HERE with your Campaign Monitor API key and LIST ID GOES HERE with your ID of the list you want to track. You’ll also need to replace occurrences of USERNAME with your username.

To find your API key, log into Campaign Monitor and click Account Settings. To find a List’s ID, navigate to that list and click change name/type.

Hooking It All Up

Now it’s time to run the Launch Agent. From the ~/Library/LaunchAgents folder:

launchctl load com.bigbucketsoftware.campaignmonitor.plist
launchctl start com.bigbucketsoftware.campaignmonitor

Assuming that worked, the file campaignmonitor.txt should have appeared in ~/Dropbox/Public/statusboard. If it didn’t you may want to try opening and looking for clues.

Finally, you can add your new Panel to Status Board! From Finder, right-click ~/Dropbox/Public/statusboard/campaignmonitor.html and click Dropbox > Get Public Link. Once you’ve got that URL on your iPad, (by emailing it, iMessaging it, or just type it out really, really carefully,) open Status Board, drag a Do-It-Yourself panel onto the board, and point it to your URL. Good luck!

Campaign Monitor Status Board Panel