woob bill

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 woob bill

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

Usage

You can run woob bill 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:

$ woob bill
Welcome to woob bill

Copyright(C) 2010-2021 The woob 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:

woob bill>

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 woob bill, 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:

bill> subscriptions

For example:

bill> 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:

bill> details <# or ID>

For example:

bill> 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 bill                         | 1.99  |
+--------------+----------------------------+-------------------------------------------+-------+

Display the history of the current billing

Use this command:

bill> history <# or ID>

For example:

bill> 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:

bill> bills <# or ID>

For example:

bill> 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:

bill> download <ID> FILENAME

For example:

bill> download 06XXXXXXXX.20120225@freemobile

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

bill> 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 woob 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