Skip to content

README.md

Latest commit

 

History

History
123 lines (92 loc) · 2.45 KB

README.md

File metadata and controls

123 lines (92 loc) · 2.45 KB

comdirect CLI

comdirect CLI tool lets you interact with your comdirect account, depot, documents and other resources.

So far only tested on macOS 12.1 and Fedora 33

Install

go install github.com/jsattler/go-comdirect/comdirect@main

Getting Started

All commands and subcommands use the singular form, so instead of accounts it's account. This is a convention to make it easier for users to remember the commands.

Usage:
    comdirect [COMMAND] [SUBCOMMAND] [OPTIONS] [ID]

Authentication

To log in you can specify the credentials through the options or when prompted.

The login command will try to store the credentials in one of the following locations depending on your OS

  • OS X KeyChain
  • Secret Service dbus interface (GNOME Keyring)
  • Windows Credentials Manager
comdirect login \
  --id=<clientID> \
  --secret=<clientSecret> \
  --username=<username> \
  --password=<password>

or

comdirect login

The logout command will remove all stored credentials, access and refresh tokens from the mentioned credential providers.

comdirect logout

Account

List basic account information

comdirect account

List all account information and balances (giro Konto, tagesgeldplus etc.)

comdirect account balance

Retrieve account information and balances for a specific account

comdirect account balance <accountID>

Retrieve account transactions for a specific account

comdirect account transaction <accountID>

Depot

Retrieve depot information

comdirect depot

Retrieve depot positions for a specific depot

comdirect depot position <depotID>

Retrieve a specific depot position for a specific depot

comdirect depot position --position=<positionID> <depotID>

Retrieve all transactions for a specific depot

comdirect depot transaction <depotID>

Document

Some notes on the current behavior:

  • the tool does not check if a file already exists. If it does, it will download and truncate the existing file
  • You need to specify the --download flag to download the files

List all documents from the postbox

comdirect document

List a specific document

comdirect document <documentID>

Download first 20 documents

comdirect document --count=20 --download

Download document by ID

comdirect document --download <documentID>