Boobill

Boobill is a console application able to view your subscription to various utilities (electricity, phone, etc.). You can show bill details, the coming bill, and download bills (usually PDF documents).

It supports the following websites:

Get Boobill

This application is part of Weboob. To install it, please read this page.

Usage

You can run Boobill without any parameter to get an interactive prompt, or specify a command to run it directly and exit just after.

In this page we will use the interactive mode:

$ boobill
Welcome to boobill

Copyright(C) 2010-2012 The Weboob Team
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, version 3 of the License.

Type "help" to display available commands.

Loaded backends:

boobill>

Use the help command to see what are the available commands.

For more information about common options of console applications, read this documentation.

The first time you launch boobill, it will ask you what backends you want to add and configure. You can also use the backends command to manage them, and to enable only specific backends.

List subscriptions

Use this command:

boobill> subscriptions

For example:

boobill> subscriptions
#1 (freemobile) 06XXXXXXXX - Forfait 60mn/60SMS à 2 euros
#2 (freemobile) 06YYYYYYYY - Forfait Free illimité à 19,99 euros

Display current billing of an account

Use this command:

boobill> details <# or ID>

For example:

boobill> details 1
+--------------+----------------------------+-------------------------------------------+-------+
|      Id      |           Label            |                   Infos                   | Price |
+--------------+----------------------------+-------------------------------------------+-------+
| 0@freemobile | Conso VOIX                 | National : 0h13min37s | International : - | 0.0   |
| 0@freemobile | Appels numéros spéciaux    | -                                         | 0.0   |
| 0@freemobile | Conso SMS                  | 42 / 60                                   | 0.0   |
| 0@freemobile | Conso MMS                  | Vous avez consommé 0 MMS                  | 0.0   |
| 0@freemobile | Conso DATA                 | Vous avez consommé 26.00 Ko               | 1.99  |
| 0@freemobile | Conso VOIX (international) | Appels émis : - | Appels reçus : -        | 0.0   |
| 0@freemobile | Conso SMS (international)  | 0                                         | 0.0   |
| 0@freemobile | Conso MMS (international)  | Vous avez consommé 0 MMS                  | 0.0   |
| 0@freemobile | Conso DATA (international) | Vous avez consommé 0 o                    | 0.0   |
| 0            | Sum                        | Generated by boobill                      | 1.99  |
+--------------+----------------------------+-------------------------------------------+-------+

Display the history of the current billing

Use this command:

boobill> history <# or ID>

For example:

boobill> history 1
+--------------+------------------------------+---------------------+-------+
|      Id      |            Label             |       Datetime      | Price |
+--------------+------------------------------+---------------------+-------+
| 0@freemobile | voix 0h11 min 14s 04XXXXXXXX | 2012-03-11 16:19:49 | 0.0   |
| 0@freemobile | sms - 06YYYYYYYY             | 2012-03-06 00:01:22 | 0.0   |
| 0@freemobile | sms - 06YYYYYYYY             | 2012-03-05 23:59:37 | 0.0   |
| 0@freemobile | sms - 06YYYYYYYY             | 2012-03-05 19:00:29 | 0.0   |
| 0@freemobile | voix 0h0 min 23s 06XXXXXXXX  | 2012-02-29 19:55:56 | 0.0   |
+--------------+------------------------------+---------------------+-------+

List all available bills for an account

Use this command:

boobill> bills <# or ID>

For example:

boobill> bills 1
+--------------------------------+------------+--------+----------+
|               Id               |    Date    | Format |  Label   |
+--------------------------------+------------+--------+----------+
| 06XXXXXXXX.20120225@freemobile | 2012-02-25 | html   | 20120225 |
| 06XXXXXXXX.20120125@freemobile | 2012-01-25 | html   | 20120125 |
+--------------------------------+------------+--------+----------+

Download a bill

Use this command:

boobill> download <ID> FILENAME

For example:

boobill> download 06XXXXXXXX.20120225@freemobile

You can change the default filename by adding a parameter, for example:

boobill> download 06XXXXXXXX.20120225@freemobile freemobile-2012-02.html

Monitor freemobile with Munin

Munin is a tool to graph on web pages system status (for example CPU usage, network traffic, etc.).

freemobile-munin is a plugin to get freemobile subscriptions and graph them into munin.

To use it, create on a munin node a symlink to freemobile-munin in the plugins directory:

$ ln -s /path/to/freemobile-munin /etc/munin/plugins/freemobile

Then, add this section in /etc/munin/plugin-conf.d/munin-node:

[freemobile]
user romain
group romain
# The plugin can be slow. It is recommended to increase the timeout to at least 30 seconds
timeout 30
# Useful for weboob to find its config files.
env.HOME /home/romain/
# Monitored options. By default only "voice" and "sms".
env.freemonitored voice sms mms data voicetoint voiceint smsint mmsint dataint
# To prevent mass connections, results are cached.
# You can set here the expiration delay (in seconds). By default is is three hours.
env.cache_expire 3600

Restart munin-node, then a graph will appear:

freemobile-munin example