{"id":21634504,"url":"https://github.com/arceryz/transact","last_synced_at":"2026-05-21T14:13:12.524Z","repository":{"id":175661396,"uuid":"654281004","full_name":"arceryz/transact","owner":"arceryz","description":"Listing bank account transactions and balances in CLI using GoCardless API. Simple script.","archived":false,"fork":false,"pushed_at":"2023-06-27T04:48:24.000Z","size":33,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-25T00:18:05.366Z","etag":null,"topics":["banking","banking-application","cli","cli-tool","finance","gocardless","linux","money","transaction"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arceryz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-06-15T19:25:20.000Z","updated_at":"2024-11-04T21:41:19.000Z","dependencies_parsed_at":"2023-09-11T16:14:47.234Z","dependency_job_id":null,"html_url":"https://github.com/arceryz/transact","commit_stats":null,"previous_names":["parcevval/transact","kairature/transact","arceryz/transact"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arceryz%2Ftransact","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arceryz%2Ftransact/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arceryz%2Ftransact/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arceryz%2Ftransact/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arceryz","download_url":"https://codeload.github.com/arceryz/transact/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244320329,"owners_count":20434090,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["banking","banking-application","cli","cli-tool","finance","gocardless","linux","money","transaction"],"created_at":"2024-11-25T03:16:57.166Z","updated_at":"2026-05-21T14:13:07.476Z","avatar_url":"https://github.com/arceryz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Transact\n\n![image](tr_list.png)\n\nIf you are like me and are annoyed with having to log in on your bank's \nwebsite with all sorts of security checks taking a tedious amount of time, just\nfor checking your balance. Look no further, this script will help you. \n\nThis simple script consisting of 1 python file allows you to list at any\ntime:\n\n- Transaction history\n- Balance\n\nThis script can NOT make transactions. It can only read transactions and\nbalance. You can see the contents of transact.py to see the exact extent of this\nscripts' functionality.\n\nUsing a terminal interface you just call `transact list` and you get a \nneat list of transactions containing\n\n- Date\n- Creditor/Debtor name\n- Amount subtracted/added\n- Currency\n- IBAN\n\nThis will allow you to keep track of money and integrate it in any user\ninterface of your choice (status bars, gui program, cli program).\n\n# How to use\n\nThis script is still in a very early stage. Over the course of time it may\nevolve with more advanced features. But the core of requesting transactions is\nfunctional. Only one account is supported at a time.\n\n## 1. Create account at [GoCardless](https://bankaccountdata.gocardless.com/overview/)\n\nYou will need an account at GoCardless at\n[https://bankaccountdata.gocardless.com/overview/](https://bankaccountdata.gocardless.com/overview/).\n\n## 2. Create API secrets.\n\nYou will need an API key and secrets to use the API safely. \nGo to\n[https://bankaccountdata.gocardless.com/user-secrets/](https://bankaccountdata.gocardless.com/user-secrets/)\nand create your secrets. *Store the secret key and secret id safely on your\ncomputer!*.\n\n## 3. Create conf.json \nYou will need a config file at $HOME/.config/transact/conf.json containing\nentries like the following:\n\n```json\n{\n    \"secret_key\": \"YOUR SECRET KEY\",\n    \"secret_id\": \"YOUR SECRET ID\",\n}\n```\n\n## 4. Selecting bank.\n\nYou now need to select your bank. You can get a list of banks by calling\n```sh\ntransact banks [COUNTRY CODE]\n```\nFor a given country code (e.g nl=netherlands).\nThis will display in your terminal (if the API key is correct).\nWrite down your banks' id, as you will need it to link.\n\n\n## 5. Link bank account.\n\nFinal step is to link your bank account. This can be done by passing the bank id\nto the `link` command:\n\n```sh\ntransact link [BANK ID]\n```\n\nYou will be given back a URL which you need to visit to verify with your bank.\nYou will be redirected to your banks website to log in and authorize this script\nfor viewing only transactions.\n\nFinally you need to actually connect your bank account by calling:\n\n```sh\ntransact accounts\n```\n\nWhich displays all accounts that are exposed by your bank. Currently this script\nonly uses the first bank account since multiple bank accounts are not supported.\n\n## 6. List your transactions.\n\nIf all went well you can now list your transactions and get balance with:\n```sh\ntransact list 10\n```\nYou can specify the number of transactions you wish to see (or none) with the\ninteger argument preceding the command.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farceryz%2Ftransact","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farceryz%2Ftransact","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farceryz%2Ftransact/lists"}