Skip to content
boobank.1 11.5 KiB
Newer Older
.\" -*- coding: utf-8 -*-
Florent's avatar
Florent committed
.\" This file was generated automatically by tools/make_man.sh.
Romain Bignon's avatar
Romain Bignon committed
.TH BOOBANK 1 "13 February 2020" "boobank 2\&.0"
Romain Bignon's avatar
Romain Bignon committed
.SH NAME
boobank \- manage bank accounts
Romain Bignon's avatar
Romain Bignon committed
.SH SYNOPSIS
.B boobank
[\-dqv] [\-b \fIbackends\fR] [\-cnfs] [\fIcommand\fR [\fIarguments\fR..]]
Romain Bignon's avatar
Romain Bignon committed
.br
.B boobank
[\-\-help] [\-\-version]

Romain Bignon's avatar
Romain Bignon committed
.SH DESCRIPTION
.LP

Romain Bignon's avatar
Romain Bignon committed
Console application allowing to list your bank accounts and get their balance, display accounts history and coming bank operations, and transfer money from an account to another (if available).
.SS Supported websites:
Romain Bignon's avatar
Romain Bignon committed
* afer (Association française d'épargne et de retraite)
Florent's avatar
Florent committed
.br
Florent's avatar
Florent committed
* amazonstorecard (Amazon Store Card)
.br
Florent's avatar
Florent committed
* americanexpress (American Express)
Florent's avatar
Florent committed
.br
Romain Bignon's avatar
Romain Bignon committed
* amundi (Amundi)
Florent's avatar
Florent committed
.br
Florent's avatar
Florent committed
* apivie (Apivie)
Florent's avatar
Florent committed
.br
Romain Bignon's avatar
Romain Bignon committed
* aviva (Aviva)
.br
Florent's avatar
Florent committed
* axabanque (AXA Banque)
Romain Bignon's avatar
Romain Bignon committed
.br
Florent's avatar
Florent committed
* banqueaccord (Banque Accord)
Florent's avatar
Florent committed
.br
Florent's avatar
Florent committed
* banquepopulaire (Banque Populaire)
Florent's avatar
Florent committed
* barclays (Barclays)
Romain Bignon's avatar
Romain Bignon committed
.br
Romain Bignon's avatar
Romain Bignon committed
* becm (Banque Européenne Crédit Mutuel)
.br
Florent's avatar
Florent committed
* bforbank (BforBank)
.br
Romain Bignon's avatar
Romain Bignon committed
* binck (Binck)
.br
* bnpcards (BNP Cartes Entreprises)
.br
Florent's avatar
Florent committed
* bnporc (BNP Paribas)
Florent's avatar
Florent committed
* bnppere (BNP Épargne Salariale)
.br
Romain Bignon's avatar
Romain Bignon committed
* bolden (Bolden)
.br
Florent's avatar
Florent committed
* boursorama (Boursorama)
Romain Bignon's avatar
Romain Bignon committed
.br
Florent's avatar
Florent committed
* bp (La Banque Postale)
Romain Bignon's avatar
Romain Bignon committed
.br
Florent's avatar
Florent committed
* bred (Bred)
Florent's avatar
Florent committed
.br
Florent's avatar
Florent committed
* btpbanque (BTP Banque)
.br
Romain Bignon's avatar
Romain Bignon committed
* caels (Crédit Agricole \- Épargne Longue des Salariés)
Florent's avatar
Florent committed
.br
Florent's avatar
Florent committed
* caissedepargne (Caisse d'Épargne)
Romain Bignon's avatar
Romain Bignon committed
.br
Florent's avatar
Florent committed
* capeasi (AXA Épargne Salariale)
.br
Florent's avatar
Florent committed
* carrefourbanque (Carrefour Banque)
Florent's avatar
Florent committed
.br
Florent's avatar
Florent committed
* cic (CIC)
Romain Bignon's avatar
Romain Bignon committed
.br
Florent's avatar
Florent committed
* cices (CIC Épargne Salariale)
Florent's avatar
Florent committed
.br
Florent's avatar
Florent committed
* citibank (Citibank)
.br
Romain Bignon's avatar
Romain Bignon committed
* cmb (Crédit Mutuel de Bretagne)
Florent's avatar
Florent committed
* cmes (Crédit Mutuel Épargne Salariale)
.br
* cmmc (Crédit Mutuel Massif Central)
.br
Florent's avatar
Florent committed
* cmso (Crédit Mutuel Sud\-Ouest)
Florent's avatar
Florent committed
.br
Florent's avatar
Florent committed
* cragr (Crédit Agricole)
Florent's avatar
Florent committed
* creditcooperatif (Crédit Coopératif)
.br
Florent's avatar
Florent committed
* creditdunord (Crédit du Nord, Banque Courtois, Kolb, Nuger, Laydernier, Tarneaud, Société Marseillaise de Crédit)
Florent's avatar
Florent committed
.br
Romain Bignon's avatar
Romain Bignon committed
* creditdunordpee (Crédit du Nord Épargne Salariale)
Florent's avatar
Florent committed
.br
* creditmutuel (Crédit Mutuel)
Florent's avatar
Florent committed
.br
Romain Bignon's avatar
Romain Bignon committed
* degiro (De giro)
.br
Florent's avatar
Florent committed
* delubac (Banque Delubac & Cie)
.br
Florent's avatar
Florent committed
* erehsbc (HSBC Épargne Salariale)
.br
* esalia (Société Générale Épargne Salariale)
.br
Florent's avatar
Florent committed
* fortuneo (Fortuneo)
Romain Bignon's avatar
Romain Bignon committed
.br
Romain Bignon's avatar
Romain Bignon committed
* ganassurances (Gan Assurances)
.br
* gmf (GMF)
.br
* groupama (Groupama)
Florent's avatar
Florent committed
.br
Florent's avatar
Florent committed
* groupamaes (Groupama Épargne Salariale)
.br
Florent's avatar
Florent committed
* hsbc (HSBC France)
Romain Bignon's avatar
Romain Bignon committed
.br
Romain Bignon's avatar
Romain Bignon committed
* hsbchk (HSBC Hong Kong)
.br
Romain Bignon's avatar
Romain Bignon committed
* humanis (Humanis Épargne Salariale)
.br
Romain Bignon's avatar
Romain Bignon committed
* ing (ING France)
Romain Bignon's avatar
Romain Bignon committed
.br
Florent's avatar
Florent committed
* kiwibank (Kiwibank)
.br
Florent's avatar
Florent committed
* lcl (LCL)
Romain Bignon's avatar
Romain Bignon committed
* lendosphere (Lendosphere)
.br
Florent's avatar
Florent committed
* linebourse (linebourse website)
.br
Romain Bignon's avatar
Romain Bignon committed
* lunchr (Lunchr)
.br
Romain Bignon's avatar
Romain Bignon committed
* myedenred (MyEdenRed)
.br
Florent's avatar
Florent committed
* n26 (Bank N26)
.br
Romain Bignon's avatar
Romain Bignon committed
* nalo (Nalo)
.br
Romain Bignon's avatar
Romain Bignon committed
* nef (La Nef)
.br
Romain Bignon's avatar
Romain Bignon committed
* netfinca (netfinca website)
.br
Florent's avatar
Florent committed
* oney (Oney)
.br
Florent's avatar
Florent committed
* paypal (PayPal)
Florent's avatar
Florent committed
* pradoepargne (Prado Épargne Salariale)
.br
Florent's avatar
Florent committed
* s2e (Épargne Salariale)
Florent's avatar
Florent committed
.br
Florent's avatar
Florent committed
* societegenerale (Société Générale)
Florent's avatar
Florent committed
.br
Romain Bignon's avatar
Romain Bignon committed
* sogecartenet (Sogecarte Net)
.br
Florent's avatar
Florent committed
* spirica (Spirica)
.br
Romain Bignon's avatar
Romain Bignon committed
* suravenir (Assurance\-vie Suravenir à travers différents courtiers (assurancevie.com, linxea, ...))
.br
Romain Bignon's avatar
Romain Bignon committed
* themisbanque (Themis)
.br
Romain Bignon's avatar
Romain Bignon committed
* ticketscesu (Tickets CESU Edenred)
.br
Florent's avatar
Florent committed
* vicseccard (Victoria's Secret Angel Card)
.br
Romain Bignon's avatar
Romain Bignon committed
* wiseed (WiSEED)
Florent's avatar
Florent committed
.br
* yomoni (Yomoni)
.SH BOOBANK COMMANDS
.TP
Florent's avatar
Florent committed
\fBadd_recipient\fR iban label
.br
Add a recipient to a backend.
.TP
Florent's avatar
Florent committed
\fBadvisor\fR
.br
Display advisors.
.TP
Florent's avatar
Florent committed
\fBbudgea\fR \fIUSERNAME\fR \fIPASSWORD\fR
.br
Export your bank accounts and transactions to Budgea.
.br

.br
Budgea is an online web and mobile application to manage your bank
.br
accounts. To avoid giving your credentials to this service, you can use
.br
this command.
.br

.br
https://www.budgea.com
.TP
Florent's avatar
Florent committed
\fBcoming\fR \fIID\fR [\fIEND_DATE\fR]
Romain Bignon's avatar
Romain Bignon committed
Display future transactions.
Florent's avatar
Florent committed
.br

.br
If END_DATE is supplied, show all transactions until this date.
.br

.br
Default is limited to 10 results.
Romain Bignon's avatar
Romain Bignon committed
\fBdebug\fR
.br
Launch a debug Python shell
.TP
Florent's avatar
Florent committed
\fBhistory\fR \fIID\fR [\fIEND_DATE\fR]
Romain Bignon's avatar
Romain Bignon committed
Display history of transactions.
Florent's avatar
Florent committed
.br

.br
If END_DATE is supplied, list all transactions until this date.
.br

.br
Default is limited to 10 results.
.TP
\fBinvestment\fR \fIID\fR
.br
Display investments of an account.
Romain Bignon's avatar
Romain Bignon committed
.TP
Florent's avatar
Florent committed
\fBlist\fR [\-\fIU\fR]
Romain Bignon's avatar
Romain Bignon committed
List accounts.
Florent's avatar
Florent committed
.br
Use \-U to disable sorting of results.
Romain Bignon's avatar
Romain Bignon committed
.TP
Florent's avatar
Florent committed
\fBpocket\fR \fIID\fR
.br
Display pockets of an account.
.TP
\fBprofile\fR
.br
Display detailed information about person or company.
.TP
Romain Bignon's avatar
Romain Bignon committed
\fBrecipients\fR \fIACCOUNT\fR
.br
List recipients of ACCOUNT
.TP
\fBtransfer\fR [\fIACCOUNT\fR \fIRECIPIENT\fR \fIAMOUNT\fR [\fILABEL\fR [\fIEXEC_DATE\fR]]]
Daniel Berthereau's avatar
Daniel Berthereau committed
Make a transfer beetwen two accounts
Romain Bignon's avatar
Romain Bignon committed
\- ACCOUNT    the source account
Romain Bignon's avatar
Romain Bignon committed
\- RECIPIENT  the recipient
Romain Bignon's avatar
Romain Bignon committed
\- AMOUNT     amount to transfer
Romain Bignon's avatar
Romain Bignon committed
\- LABEL      label of transfer
Romain Bignon's avatar
Romain Bignon committed
\- EXEC_DATE  date when to execute the transfer
.SH WEBOOB COMMANDS
Romain Bignon's avatar
Romain Bignon committed
.TP
\fBbackends\fR [\fIACTION\fR] [\fIBACKEND_NAME\fR]...
.br
Select used backends.
.br

.br
ACTION is one of the following (default: list):
.br
Romain Bignon's avatar
Romain Bignon committed
* enable         enable given backends
.br
* disable        disable given backends
Romain Bignon's avatar
Romain Bignon committed
* only           enable given backends and disable the others
Romain Bignon's avatar
Romain Bignon committed
* list           list backends
Romain Bignon's avatar
Romain Bignon committed
* add            add a backend
Romain Bignon's avatar
Romain Bignon committed
* register       register a new account on a website
Romain Bignon's avatar
Romain Bignon committed
* edit           edit a backend
Romain Bignon's avatar
Romain Bignon committed
* remove         remove a backend
Romain Bignon's avatar
Romain Bignon committed
* list\-modules   list modules
Romain Bignon's avatar
Romain Bignon committed
.TP
Romain Bignon's avatar
Romain Bignon committed
\fBcd\fR [\fIPATH\fR]
Romain Bignon's avatar
Romain Bignon committed
.br
Follow a path.
Romain Bignon's avatar
Romain Bignon committed
.br
Romain Bignon's avatar
Romain Bignon committed
".." is a special case and goes up one directory.
.br
"" is a special case and goes home.
Romain Bignon's avatar
Romain Bignon committed
.TP
\fBcondition\fR [\fIEXPRESSION\fR | off]
.br
Florent's avatar
Florent committed
If an argument is given, set the condition expression used to filter the results. See CONDITION section for more details and the expression.
.br
If the "off" value is given, conditional filtering is disabled.
.br

.br
If no argument is given, print the current condition expression.
Romain Bignon's avatar
Romain Bignon committed
.TP
\fBcount\fR [\fINUMBER\fR | off]
.br
If an argument is given, set the maximum number of results fetched.
.br
NUMBER must be at least 1.
.br
"off" value disables counting, and allows infinite searches.
.br

.br
If no argument is given, print the current count value.
Romain Bignon's avatar
Romain Bignon committed
.TP
\fBformatter\fR [list | \fIFORMATTER\fR [\fICOMMAND\fR] | option \fIOPTION_NAME\fR [on | off]]
.br
If a FORMATTER is given, set the formatter to use.
.br
You can add a COMMAND to apply the formatter change only to
.br
a given command.
.br

.br
If the argument is "list", print the available formatters.
.br

.br
If the argument is "option", set the formatter options.
.br
Valid options are: header, keys.
.br
If on/off value is given, set the value of the option.
.br
If not, print the current value for the option.
.br

.br
If no argument is given, print the current formatter.
Romain Bignon's avatar
Romain Bignon committed
.TP
\fBlogging\fR [\fILEVEL\fR]
.br
Set logging level.
.br

.br
Availables: debug, info, warning, error.
.br
* quiet is an alias for error
.br
* default is an alias for warning
.TP
Florent's avatar
Florent committed
\fBls\fR [\-d] [\-\fIU\fR] [\fIPATH\fR]
Romain Bignon's avatar
Romain Bignon committed
.br
List objects in current path.
Romain Bignon's avatar
Romain Bignon committed
.br
If an argument is given, list the specified path.
Florent's avatar
Florent committed
.br
Florent's avatar
Florent committed
Use \-U option to not sort results. It allows you to use a "fast path" to
Florent's avatar
Florent committed
.br
return results as soon as possible.
.br
Florent's avatar
Florent committed
Use \-d option to display information about a collection (and to not
Florent's avatar
Florent committed
.br
display the content of it). It has the same behavior than the well
.br
Florent's avatar
Florent committed
known UNIX "ls" command.
Florent's avatar
Florent committed
.br

.br
Default is limited to 40 results.
Romain Bignon's avatar
Romain Bignon committed
.TP
\fBquit\fR
.br
Quit the application.
.TP
\fBselect\fR [\fIFIELD_NAME\fR]... | "$direct" | "$full"
.br
If an argument is given, set the selected fields.
.br
$direct selects all fields loaded in one http request.
.br
$full selects all fields using as much http requests as necessary.
.br

.br
If no argument is given, print the currently selected fields.

.SH OPTIONS
.TP
\fB\-\-version\fR
show program's version number and exit
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-b BACKENDS\fR, \fB\-\-backends=BACKENDS\fR
what backend(s) to enable (comma separated)
Florent's avatar
Florent committed
.TP
\fB\-e EXCLUDE_BACKENDS\fR, \fB\-\-exclude\-backends=EXCLUDE_BACKENDS\fR
what backend(s) to exclude (comma separated)
.TP
\fB\-I\fR, \fB\-\-insecure\fR
do not validate SSL
Florent's avatar
Florent committed
.TP
\fB\-\-nss\fR
Use NSS instead of OpenSSL
Romain Bignon's avatar
Romain Bignon committed
.TP
\fB\-\-auto\-update\fR
Automatically check for updates when a bug in a module is encountered

.SH LOGGING OPTIONS
Romain Bignon's avatar
Romain Bignon committed
.TP
\fB\-d\fR, \fB\-\-debug\fR
Florent's avatar
Florent committed
display debug messages. Set up it twice to more verbosity
Romain Bignon's avatar
Romain Bignon committed
.TP
\fB\-q\fR, \fB\-\-quiet\fR
display only error messages
.TP
\fB\-v\fR, \fB\-\-verbose\fR
display info messages
.TP
\fB\-\-logging\-file=LOGGING_FILE\fR
file to save logs
Romain Bignon's avatar
Romain Bignon committed
.TP
\fB\-a\fR, \fB\-\-save\-responses\fR
save every response
Florent's avatar
Florent committed
.TP
\fB\-\-export\-session\fR
log browser session cookies after login

.SH RESULTS OPTIONS
Romain Bignon's avatar
Romain Bignon committed
.TP
\fB\-c CONDITION\fR, \fB\-\-condition=CONDITION\fR
Florent's avatar
Florent committed
filter result items to display given a boolean expression. See CONDITION section
for the syntax
.TP
\fB\-n COUNT\fR, \fB\-\-count=COUNT\fR
Florent's avatar
Florent committed
limit number of results (from each backends)
.TP
\fB\-s SELECT\fR, \fB\-\-select=SELECT\fR
select result item keys to display (comma separated)

.SH FORMATTING OPTIONS
.TP
\fB\-f FORMATTER\fR, \fB\-\-formatter=FORMATTER\fR
Florent's avatar
Florent committed
select output formatter (account_list, advisor_list, csv, htmltable,
investment_list, json, json_line, multiline, ofx, ops_list, pretty_qif, qif,
recipient_list, simple, table, transfer, webkit)
.TP
\fB\-\-no\-header\fR
do not display header
.TP
\fB\-\-no\-keys\fR
do not display item keys
Romain Bignon's avatar
Romain Bignon committed
.TP
\fB\-O OUTFILE\fR, \fB\-\-outfile=OUTFILE\fR
file to export result
Florent's avatar
Florent committed
.SH CONDITION
Florent's avatar
Florent committed
The \-c and \-\-condition is a flexible way to filter and get only interesting results. It supports conditions on numerical values, dates, durations and strings. Dates are given in YYYY\-MM\-DD or YYYY\-MM\-DD HH:MM format. Durations look like XhYmZs where X, Y and Z are integers. Any of them may be omitted. For instance, YmZs, XhZs or Ym are accepted.
Florent's avatar
Florent committed
The syntax of one expression is "\fBfield operator value\fR". The field to test is always the left member of the expression.
.LP
The field is a member of the objects returned by the command. For example, a bank account has "balance", "coming" or "label" fields.
.SS The following operators are supported:
.TP
=
Test if object.field is equal to the value.
.TP
!=
Test if object.field is not equal to the value.
.TP
>
Test if object.field is greater than the value. If object.field is date, return true if value is before that object.field.
.TP
<
Test if object.field is less than the value. If object.field is date, return true if value is after that object.field.
.TP
|
This operator is available only for string fields. It works like the Unix standard \fBgrep\fR command, and returns True if the pattern specified in the value is in object.field.
.SS Expression combination
Florent's avatar
Florent committed
.LP
You can make a expression combinations with the keywords \fB" AND "\fR, \fB" OR "\fR an \fB" LIMIT "\fR.
.LP
The \fBLIMIT\fR keyword can be used to limit the number of items upon which running the expression. \fBLIMIT\fR can only be placed at the end of the expression followed by the number of elements you want.
Florent's avatar
Florent committed
.SS Examples:
.nf
.B boobank ls \-\-condition 'label=Livret A'
.fi
Display only the "Livret A" account.
.PP
.nf
.B boobank ls \-\-condition 'balance>10000'
.fi
Display accounts with a lot of money.
.PP
.nf
.B boobank history account@backend \-\-condition 'label|rewe'
.fi
Get transactions containing "rewe".
.PP
.nf
Florent's avatar
Florent committed
.B boobank history account@backend \-\-condition 'date>2013\-12\-01 AND date<2013\-12\-09'
Florent's avatar
Florent committed
.fi
Get transactions betweens the 2th December and 8th December 2013.
Florent's avatar
Florent committed
.PP
.nf
.B boobank history account@backend \-\-condition 'date>2013\-12\-01  LIMIT 10'
.fi
Get transactions after the 2th December in the last 10 transactions
Florent's avatar
Florent committed

Romain Bignon's avatar
Romain Bignon committed
.SH COPYRIGHT
Romain Bignon's avatar
Romain Bignon committed
Copyright(C) 2010-2020 Romain Bignon, Christophe Benz
Romain Bignon's avatar
Romain Bignon committed
.LP
Florent's avatar
Florent committed
For full copyright information see the COPYING file in the weboob package.
Romain Bignon's avatar
Romain Bignon committed
.LP
.RE
.SH FILES
Romain Bignon's avatar
Romain Bignon committed
"~/.config/weboob/backends" 
Romain Bignon's avatar
Romain Bignon committed
Home page: http://weboob.org/applications/boobank