Mac Widget: Vidéotron Internet Usage Monitor

Important note: the software below is now officially unsupported.
I’m not a Videotron client anymore, so it became difficult, and without interest, for me to continue development of this solution to track your bandwidth quota.

If you know any developer that might be interested in continuing development and support, feel free to send them a note.
(JavaScript is the main programming language.)

 

Download the widget version 1.3.9

What’s new in 1.3.9
Bugfix: During the 1st day of the month, you could see
a warning about reaching ‘infinity’ at the end of the month!


Update: There is now a Google Chrome extension that replicates this widget’s functionalities (and adds notifications). Get it on the Chrome Web Store.


Having received earlier this week a letter from Vidéotron, my ISP, about my account getting capped at 100GB monthly in the upcoming months, I decided I needed an easy way to monitor my monthly bandwidth usage. A Dashboard widget was a good fit.

I downloaded a couple of widget samples from Apple.com, and started a new widget from there.

The end result:

A nice little widget, sitting on my Dashboard, that can tell me how much of my monthly quota I’ve used so far.
Preferences are: Vidéotron Use Key (something that looks like FFFFFF1234567890), and if you’d like to visualize upload (versus download) using a different color, on the graph.

Enjoy, fellow Vidéotron users.

Changelog

  • 1.3.9 - Bugfix: During the 1st day of the month, you could see a warning about reaching ‘infinity’ at the end of the month!
  • 1.3.8 - Improvement: Give a warning when the entered User Key is not the right length (16 characters).
  • 1.3.7 - Bugfix: date conversions were broken!
  • 1.3.6 – Bugfix: Small fix for the ‘now’ arrow in the small UI.
    Bugfix: finally working on 10.4 and Lion (10.7).
    Improvement: New version available looks better in French and on small UI.
  • 1.3.5 – Bugfix: Incorrect end date calculation placed the ’now’ cursor at the wrong position.
    Bugfix: trying to make it work on 10.4.
  • 1.3.4 – Improvement: try to prevent getting blocked by Videotron, for sending too many requests too fast. Also, better overall error handling.
  • 1.3.3 – Bugfix: minimal UI was broken since 1.3.0. Also added surplus calculation details in Console, and changed back surplus number in green (was changed to red for no reason).
  • 1.3.2 – Bugfix & improvements: spinning wheel now disappears when it should. Current now appears in the preferences. New versions notifications will appear below the widget.
  • 1.3.1 – Bugfix for Mac OS X 10.6 and lower (1.3.0 only worked on Lion… Sorry!)
  • 1.3.0 – Bugfix & Improvement: Now using the new public Videotron API, instead of data scraping the consumption web page! You’ll need your User Key. You can find it in your Videotron Customer Center, in the User Key tab of the Your Profile page.
  • 1.2.8 – Bugfix: wrong plan would become selected when new plans became available. Improvement: the bandwidth used today is now accounted for. Improvement: better warning text when your limit is busted, including the approx. amount you’ll be charged for the extra.
  • 1.2.7 – Bugfix: typo in JavaScript made the widget unusable on Lion. Fixed. (Thanks Anonymous for the pointer.)
  • 1.2.6 – Bugfix: regression in 1.2.5; couldn’t save preferences!
  • 1.2.5 – Bugfix: Basic (2GB) plan couldn’t be selected.
  • 1.2.4 – Updated Vidéotron logo; bug fixed: accumulated daily surplus and ‘now’ arrow were 1 day off; clarified that the last updated date was in fact “$date @ 23h59″; visual fix when new versions are available.
  • 1.2.3 – Changed text in options, to clarify that the data transfer packages are ‘extras’, and the ‘Plan’ option is what will define your monthly limit.
  • 1.2.2 – Added option to select data transfer packages bought this month. The selected value will be reset when the billing month changes.
  • 1.2.1 – Missing Business plans from 1.2.0; added an option to display upload using a different color on the graph.
  • 1.2.0 – Easier configuration; new version available notification; now displaying numeric deviation from daily limit (surplus) – this was only shown using a small arrow on the graph before; added overcharge ($) you should expect on your invoice, if you’re over your limit.
  • 1.1.6 – Better handling for wrong username; people entering anything else than their VLXXXXXX Vidéotron username will now get a relevant error message.
  • 1.1.5 – Fetch new data less often; was previously checking for new data every 15 minutes when the Dashboard was open; changed that to once a day.
  • 1.1.4 – Added small arrows on meters to show the current date. If the meter is higher than the arrow, it means you’ve transferred too much in regard to the current date versus the date you’re invoiced. Red arrow = bad; green arrow = good.
  • 1.1.3 – Beta for 1.1.4
  • 1.1.2 – Small visual changes: loading animated GIF, numbers formatted as 0.xx instead of .xx.
  • 1.1.1 – New French localization option; new minimal look option; fixed incorrect dates (all dates were one month early).
  • 1.0.1 – Fixed missing percentage when using combined quota.
  • 1.0 – First version.

268 Responses to “Mac Widget: Vidéotron Internet Usage Monitor”

  1. Guizmo says:

    Bonjour Guillaume,

    J’aurais une petite suggestion/faveur à demander, si cela est faisable bien entendu.

    Depuis que Vidéotron utilise un API, j’en arrache beaucoup avec le widget, puisqu’il refresh automatiquement dès qu’on ouvre le Dashboard.

    Le widget a toujours fonctionné ainsi, et tout était beau. Mais depuis que c’est l’API de Vidéotron, je me fais bannir car j’ouvre trop souvent mon Dashboard.

    J’utilise mon Dashboard pour la calculatrice, convertir des unités, du code binaire, traduire des mots, et tout plein de gogosses, j’ai environ 20 widgets. Je peux accéder à mon Dashboard, 10 fois par 5 minutes parfois.

    Donc tout ça pour dire que, ce serait super si on pourrait avoir un option pour désactiver le auto-refresh, et le faire manuellement avec un raccourci clavier ou un bouton sur l’interface du widget. Je ne demande pas d’enlever le refresh automatique, mais simplement d’ajouter un option permettant de le faire manuellement. Dans mon cas ce serait beaucoup plus utile.

    Je ne suis pas développeur logiciel, donc je n’ai aucune idée de la faisabilité de la chose. Je me croise les doigts. :)

    Merci,
    Guizmo

    • Si tu utilises la dernière version du widget (tu peux voir la version du widget dans les préférences), le auto-refresh est cédulé pour se faire une fois aux 6 heures, pas plus souvent.
      Les seules fois qu’il se rafraichira plus souvent est si tu vas dans les options, et click Done, ou si ton process Dashboard (Dock en fait) crash ou se fait tuer, et redémarre.
      Je serais curieux de voir ce qui se passe dans Console.app, pendant que tu lances le Dashboard a plusieurs reprises, et donc pendant que le widget est rafraichit a multiples reprises.

  2. Lord Kythe says:

    Salutations M. Boudreau, je voulais confirmer qu’il s’agit d’une situation isolée à mon cas: depuis plusieurs jours, je n’obtiens que le message “Can’t send an API request right now; Videotron would block you for abuse. (…)”. Je dois mentionner que je viens de faire la mise à jour Lion, mais ça marchait bien même après la mise à jour jusqu’à maintenant. Merci encore pour le super Widget! Bonne fin de semaine.

    • This is indeed just you; it means the widget tried to initiate too many calls to the Videotron API.
      Make sure you’re running the latest 1.3.9 version, and if you are, just uninstall the widget for 24h, then re-installing will fix your issue.

  3. Eric B says:

    Merci d’avoir maintenu ce pratique widget pendant plusieurs années en tout cas!

  4. Martin Nadeau says:

    Malheureusement, l’update de Mac OS X 10.7.1 semble avoir “brisé” le widget. Je n’ai maintenant plus qu’une fenêtre blanche. Qu’est-ce que je vais faire moi maintenant pour contrôler ma dépendance à Netflix? ;-)

    Mais sérieusement, je me demandais si c’était bien une incompatibilité générale avec 10.7.1, ou si c’est seulement sur mon système.

    • Martin Nadeau says:

      Oups, il semblerait que le widget s’est magiquement remis à fonctionner.

      Désolé pour la fausse alerte.

  5. Alex says:

    :-( ca y’est le widget n’est plus développé :’-(

    C’est triste. Je l’utilise depuis des années lorsque j’ai débarqué sur Mac. J’espère vraiment que quelqu’un va le reprendre pour continuer le travail car ça en vaut la peine.

    Merci au développeur pour tout ton travail et ton énergie. Pour ta réactivité aussi. Bonne continuation pour toi dans tes autres projets.

    Et croisons les doigts pour que le widget puisse repartir en n’étant pas orphelin.

    Merci.

  6. louis bergeron says:

    Pourquoi ne pas mettre le Widget dans le AppStore et en tirer un revenu et continuer de le supporter. Le produit est tellement reconnu que même Videotron y collabore en fournissant un code pour le faire fonctionner.

    • On ne peut pas publier un widget sur le App Store Mac. Il faudrait que je modifie mon widget pour que ce soit une app, et non un widget, pour pouvoir le vendre… Ca ne vaut pas la peine. Ca me couterait beaucoup plus de temps pour créer une vraie app que l’$ que je pourrais en tirer.

  7. louis bergeron says:

    Le widget dans sa forme actuelle va continuellement chercher les informations chez Videotron comme on le voit dans la console. Je l’ai enlever totalement et je vais l’installer de nouveau pour voir si cela continue.

Leave a Reply