River Levels Widget v1.2

Update: A new version is available that fixes a corrupted archive in version 1.2.
RiverLevels 1.0 Screen Shot

The RiverLevels widget provides an easy way to monitor the amount of water flowing in your favorite streams and rivers right from your Dashboard. The RiverLevels widget is of particular interest to whitewater kayakers and canoeists.

Once any United States Geological Survey (USGS) stream-gauge station is selected, it is automatically refreshed to always provide you with the latest graph of the water-level. As of version 1.2 you can choose between two graph styles: discharge in cubic feet per second (CFS) and water-height in feet.

This widget is Free software, licensed under the GNU General Public License (GPL) version 3 or later.


  • OS X – 10.4 “Tiger” or later

Change Log:

1.2 (2008-02-06)

  • Fixed Leopard (10.5) compatability bug.
  • Added the ability to choose Gauge Height (ft) in addition to discharge (CFS).

1.1 (2007-01-08)

  • Fixed graphs extending off bottom of widget
  • Fixed invisibility of front refresh icon

Update: A new version is available that fixes a corrupted archive in version 1.2.


  1. Just tried River Levels 1.2. It starts then quits right away. I am on a MacBook running 10.5.1

  2. River Levels is one of my favorite widgets ever. I was waiting for you to update it for Leopard. I downloaded it today and it’s still not there yet, although you’ve updated it. Maybe one more bug…

  3. Thanks for the bug reports. The Widget is working fine on my system (10.5.1 on MacBook Pro) in the Dashboard, DashCode, and Safari. If anyone who is having a problem can open the widget in DashCode and let me know what error[s] are occurring, then it will help me make a fix.

    – Adam

  4. I tried it 3 times on my imac 10.4.11. I can’t get it to do anything. Not seeing a defined widget space or anyway to flip it or seek info

  5. I downloaded your river levels widget, but could not get it to operate. I’m using an iMac desktop runing system version10.4.11. I’m unable to locate an info button to flip the widget. Is there and earlier pre-Leopard version available?

  6. For those who are having problems with version 1.2, you can download previous releases from the project page here:


  7. Update: A new version is available that fixes a corrupted archive in version 1.2.

  8. Howdy,

    I am wondering if you’d be interested in modifying your widget code for use in various CMS’s like WordPress and Drupal? If you’re not interested or don’t have the time, might you have some suggestions on how to go about it?


  9. @pdxwebhead, I hadn’t thought of making the widget into a CMS plugin, but you are more than welcome to do so. The latest version of the source is available on GitHub at http://github.com/adamfranco/riverlevels.wdgt/. Like all Dashboard widgets, this one is just a little HTML page, though there are a few calls that are made that do not work in most browsers, mostly related to the widget object.

    You could probably create a widget object that implemented the following methods and the rest of the widget would work:

    widget.openURL(url) – could be implemented as window.location = url;
    widget.setPreferenceForKey(key, value)

    That said, implementing that API may be quite challenging due to the need to store preferences on a server somewhere. Additionally, there is the challenge of cross-site XMLHTTPRequests for fetching station data. As well, since web-pages are generally reloaded often (unlike dashboard widgets), there isn’t the need for the dynamic refreshing of the graph.

    Were I to make this into a plugin for WordPress or Drupal where the site administrator is choosing the station, I’d probably rewrite the whole thing in PHP and just display a static <img src='http://....'/> tag for the selected station. If you pursue this, good luck! I’d love to hear how it turns out.

  10. Pingback: AdamFranco.com » Blog Archive » River Levels Widget v.1.2.2 available

  11. I have OSX 10.5.8. Panther. I can’t get River Levels 1.2.2 to function. Any other version that might work with Panther?

Leave a Reply

Your email address will not be published. Required fields are marked *