Custom Speedometer Widget

Overview


The Custom Speedometer Widget lets you display a single number as a speedometerAll you have to do is provide a URL, and it displays the number it finds there, live on your dashboard. We even remember the highest value you've shown over the last 30 days.


Source Data


The format for the widget's source is incredibly simple. It's just the number that you want it to show, without any formatting.

So, if you want to show something like the penguins example above, just open your favorite text editor, type the number 48634, and save the file.
48634
If the number is big, we'll automatically take care of displaying a shortened version. For example, we'll show 5364312 as 5.3m.

Formatting Your Data


If you want to get fancy, you can also tell us how you want us to display your data. In order to do that, you'll need to make your source data available as JSON.

For example, let's say you have a speedometer that you're using to display time values that can be as low as 50 milliseconds and as high as 15 minutes. In that situation, you'd send small values like this:
{
  "value": 486,
  "formatted": "486ms"
}
and larger values like this:
{
  "value": 420000,
  "formatted": "7 min"
}
That way we'll know exactly what you mean by "486ms" and "7 min", and we'll know exactly where to point the speedometer's needle.

Setting Speedometer Ranges


By default, the far left side of the speedometer is 0, and the far right side of the speedometer is the highest value you've shown over the last 30 days. This usually works pretty well, but if you want, you change also change these start and end values.

For example, if you want the speedometer to be all the way to the left at 300 and all of the way to the right at 10,000, you'd send start and end values like this:
{
  "value": 486,
  "start": "300",
  "end": "10000"
}

Sharing Your Data with Dash

Now you need to get your text file to the internet so that Dash can see it. If you've got a web server, by all means, use that! For most people, though, Dropbox is a great solution. Just move your file to your dropbox folder, right click, and select "Share Dropbox Link".



That copies a link to the file that Dash can see, so then you just have to paste that link into the widget's Data URL box.


30 Day Max (and min)


We automatically keep track of the 30 day maximum and minimum values that you've shown on your speedometer so we'll know which direction to point the needle. All you have to do is give us the current speedometer value and we'll take care of the rest.

Update Frequency


We grab new data from your URL every 30 seconds. (We may decide to change this later.)

Suggestions


If you have any suggestions about how we can make the Custom Speedometer widget better, be sure to let us know!

Feedback and Knowledge Base