{"id":34751392,"url":"https://github.com/richwalm/upbank2firefly","last_synced_at":"2025-12-25T05:19:32.359Z","repository":{"id":88998998,"uuid":"412996542","full_name":"richwalm/upbank2firefly","owner":"richwalm","description":"Up Bank to Firefly III Converter","archived":false,"fork":false,"pushed_at":"2025-02-01T01:54:16.000Z","size":25,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-01T02:33:44.788Z","etag":null,"topics":["docker","firefly-iii","flask","python","up-banking","upbank"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/richwalm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-03T06:32:26.000Z","updated_at":"2025-02-01T01:54:20.000Z","dependencies_parsed_at":"2024-07-09T11:56:03.788Z","dependency_job_id":null,"html_url":"https://github.com/richwalm/upbank2firefly","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/richwalm/upbank2firefly","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/richwalm%2Fupbank2firefly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/richwalm%2Fupbank2firefly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/richwalm%2Fupbank2firefly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/richwalm%2Fupbank2firefly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/richwalm","download_url":"https://codeload.github.com/richwalm/upbank2firefly/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/richwalm%2Fupbank2firefly/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28020374,"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","status":"online","status_checked_at":"2025-12-25T02:00:05.988Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["docker","firefly-iii","flask","python","up-banking","upbank"],"created_at":"2025-12-25T05:19:31.892Z","updated_at":"2025-12-25T05:19:32.350Z","avatar_url":"https://github.com/richwalm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Up Bank to Firefly III Converter\n\n## Description\n\nThis is a [Python 3](https://www.python.org/) [Flask application](https://palletsprojects.com/p/flask/) to process [Up Bank's API webhooks](https://developer.up.com.au/#webhooks), allowing transactions from [Up Bank](https://up.com.au/) to be automatically added to [Firefly III](https://www.firefly-iii.org/).\n\nIt also includes a command line interface so transactions can be obtained and deleted manually.\n\n## Install\n\nAlthough it can be run directly if Flask is installed, it's been designed to work as a [Docker](https://www.docker.com/) container using [Docker Compose](https://docs.docker.com/compose/).\n\nWhen using the provided `docker-compose.yml` file, core settings are to be provided in the `.env` file. Please see the included [`.env.template`](.env.template) for an initial template.\n\nOnce settings have been configured, the container can be started with;\n```\ndocker compose build \u0026\u0026 docker compose up -d\n```\n\nIt's recommended that Firefly is running on the same host or network as Up Bank requests that webhook responses are performed quickly. No asynchronously processing is currently performed.\n\n### Reverse Proxy\n\nIf your Firefly III install is publicly available behind a reverse proxy, I would suggest placing it under the same host using an unused path.\nThis way you wouldn't need to manage separate HTTPS certificates.\n\n#### Nginx Example\n\n```\nlocation /upbank2firefly/ {\n   proxy_pass http://127.0.0.1:8083/;\n   proxy_redirect     off;\n   proxy_set_header   Host                 $host;\n   proxy_set_header   X-Real-IP            $remote_addr;\n   proxy_set_header   X-Forwarded-For      $proxy_add_x_forwarded_for;\n   proxy_set_header   X-Forwarded-Proto    $scheme;\n}\n```\n\n#### Caddy Example\n\n```\n@firefly host firefly.example.org\nhandle @firefly {\n\thandle_path /upbank2firefly/* {\n\t\treverse_proxy 127.0.0.1:8083\n\t}\n}\n```\n\n## Command Line Interface\n\nThe command options can be executed through Docker Compose with;\n`docker compose exec -e FLASK_APP=main upbank2firefly flask [command]`\n\n### Get\n\n```\nUsage: flask get [OPTIONS] [IDS]...\n\n  Get transactions with Up transaction IDs.\n```\n\n### Delete\n\n```\nUsage: flask delete [OPTIONS] [IDS]...\n\n  Delete transactions with Up transaction IDs.\n```\n\n### Get All\n\n```\nUsage: flask getall [OPTIONS]\n\n  Obtains all transactions.\n\nOptions:\n  -a, --account-id UUID           Limit to only this account's tranactions.\n  -s, --since [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]\n                                  Only transactions since this timestamp.\n  -u, --until [%Y-%m-%d|%Y-%m-%dT%H:%M:%S|%Y-%m-%d %H:%M:%S]\n                                  Only transactions until this timestamp.\n  -o, --output-only               Print Up transactions IDs only. Don't add to Firefly.\n```\n\n## Credits\n\nWritten by Richard Walmsley \\\u003crichwalm+upbank2firefly@gmail.com\\\u003e. Released under the [ISC License](LICENSE.txt).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frichwalm%2Fupbank2firefly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frichwalm%2Fupbank2firefly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frichwalm%2Fupbank2firefly/lists"}