Geeklet for SurplusMeter
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Geektool script for SurplusMeter

SurplusMeter is a broadband monitoring tool for Mac, for those of us with limited data plans.

Geektool is an awesome utility to customize a Mac desktop with all sorts of useful (or plain eye candy) information.

I exceeded my monthly data plan today, and decided to write this script for displaying a summary of my broadband usage on my desktop.


  1. Download the script somewhere.
  2. Go to System Preferences -> Geektool.
  3. Drag-n-drop a new "Shell" type of Geeklet.
  4. In the "Command" field provide "python /path/to/" with the correct path to the file.
  5. Since the script uses python string formatting, it seems to format correctly when using a fixed type font like Monaco or Courier, and a little disturbed otherwise.


  1. "Month so far" shows the broadband usage data for your current monthly cycle, based on the starting date provided to SurplusMeter. The "Limit" is the total monthly broadband limit.
  2. It shows data in MB only. Feel free to tinker with the script if you prefer GB.