AQHBCI-TOOL4(1)

📦
version 6.9.2 · 7 versions
, in ubuntu stonking

💖 AQHBCI-TOOL4 💖

okay bestie, gather round, because this is aqhbci-tool4 from the AQHBCI-TOOL4(1) manual and she is the command line girlie for setting up, tweaking and debugging your HBCI stuff. bank drama? handled. ✨

✨ NAME ✨

aqhbci-tool4 — Command line tools for setup, modification and debugging of HBCI settings.

🦋 SYNOPSIS 🦋

aqhbci-tool4 [global options] <command> [command options]

🌸 DESCRIPTION 🌸

so basically, aqhbci-tool4(1) is the main character you call when you wanna set up and manage AqBanking's HBCI users, customers and accounts. that's the whole vibe. no cap. 💅

👑 OPTIONS 👑

real talk, there are two common options you have to keep so careful apart from each other, because mixing them up is giving chaos:

  • -c CUSTOMER_ID → this is the German "Kunden-ID", aka "Kundennummer".
  • -u USER_ID → this one is the German "Benutzerkennung".

if your bank handed you both, please please please double check that you're not swapping one for the other. it's a whole trap. 😭

This is version 6.9.2

here come the flags:

  • -D PARAM, --cfgdir=PARAM — specify the configuration folder 📁
  • -n, --noninteractive — select non-interactive mode. this one automatically returns a confirmative answer to any non-critical message, so it just says "yeah sure" for you. iconic lazy-girl behaviour, lowkey. 💤
  • -A, --acceptvalidcerts — automatically accept all valid TLS certificate 🔐
  • --charset=PARAM — specify the output character set
  • -P PARAM, --pinfile=PARAM — specify the PIN file 🎀
  • --opticaltan=PARAM — specify an external tool to display optical TAN challenges 👀
  • -h, --help — show this help screen. and for help on commands? run aqbanking-cli <COMMAND> --help. 🫶

🌈 COMMANDS 🌈

the full roster, no one left out:

  • mkpinlist — this command creates an empty PIN file
  • adduser — adds a user (→ setup HBCI for a bank)
  • deluser — deletes a user.
  • getkeys — requests the server’s key
  • getcert — requests the server’s SSL certificate
  • createkeys — create user keys.
  • sendkeys — send the user keys to the bank.
  • changekeys — change user keys (and media).
  • getbankinfo — request bank information
  • getaccounts — requests account list for a user
  • getaccsepa — requests SEPA account list for a user
  • gettargetacc — requests target account list for a user
  • getsysid — requests a system id for the given user
  • getitanmodes — requests supported iTAN modes for the given user
  • listitanmodes — show a list of supported iTAN modes for the given user
  • setitanmode — select an iTAN mode for the given user
  • listusers — list the users
  • listaccounts — list the accounts
  • changepin — change the PIN of a key file
  • unblockpin — unblock the PIN in PIN TAN mode.
  • iniletter — print the INI letter for a given user
  • addaccount — manually add account
  • delaccount — deletes account
  • sethbciversion — set the HBCI protocol version to be used
  • setMaxTransfers — set the maximum number of transfers/debit notes per job
  • setsepaprofile — set the SEPA profile for transfers/debit notes
  • setTanMediumId — set the medium id for some PIN/TAN methods (like mTAN)
  • setTanMechanism — overwrite TAN mechanism to use
  • adduserflags — set special flags for the given user
  • subuserflags — unset special flags for the given user
  • addaccountflags — set special flags for the given account
  • subaccountflags — reset special flags for the given account
  • logfile — make an AqBanking log file anonymous
  • versions — print the program and library versions

and for help on the options available to specific commands? run this, bestie:

aqhbci-tool4 <COMMAND> --help

🎀 FILES 🎀

  • $HOME/.aqbanking/ — all files in this directory are part of the AqBanking configuration. even though mostly all files are in a simple plaintext syntax, you MUST NOT change anything in here without using the tools or libraries provided by AqBanking — unless you know exactly what you are doing. seriously. those files may be subject to changes in future AqBanking releases.
fr fr, don't go poking around in there with your bare hands. use the tools. 🙈

💀 BUGS 💀

probably lots 😭 please post them to the mailing list (see Resources below) or file an issue in the issue tracker <https://www.aquamaniac.de/rdm/projects/aqbanking/issues> when you find them.

🧚 RESOURCES 🧚

the AqBanking wiki <https://www.aquamaniac.de/rdm/projects/aqbanking/wiki> provides useful help for setting up AqBanking — even though it is only available in German. 🥨 on the AqBanking mailing lists <https://mailman.aqbanking.de/listinfo/aqbanking-user> you can give kudos to the developers or get your questions answered. go hype them up, they deserve it. 🫶

🍓 COPYING 🍓

Copyright (C) Martin Preuß. Free use of this software is granted under the terms of the GNU General Public License (GPL).

The manpage was composed by Micha Lenk and converted by the nifty tool AsciiDoc into a manpage. nifty is right, that tool ate. 💅

💜 AUTHOR 💜

Micha Lenk

and that's the whole page, bestie — AQHBCI-TOOL4(1), dated 2026-08-13, straight from the AQHBCI-TOOL4(1) manual. go set up those HBCI users, you're gonna slay. periodt. ✨💖

📦 where this page comes from