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:
