{"id":30906176,"url":"https://github.com/cbos/fireflyiii-import-preprocessor","last_synced_at":"2025-10-15T12:35:43.493Z","repository":{"id":308951592,"uuid":"1034655562","full_name":"cbos/fireflyiii-import-preprocessor","owner":"cbos","description":"A preprocessor to prepare a CSV import of Firefly III","archived":false,"fork":false,"pushed_at":"2025-09-03T12:00:30.000Z","size":23,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-03T13:31:48.195Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","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/cbos.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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-08T18:49:24.000Z","updated_at":"2025-09-03T11:59:34.000Z","dependencies_parsed_at":"2025-08-08T22:33:35.609Z","dependency_job_id":null,"html_url":"https://github.com/cbos/fireflyiii-import-preprocessor","commit_stats":null,"previous_names":["cbos/fireflyiii-import-preprocessor"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cbos/fireflyiii-import-preprocessor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbos%2Ffireflyiii-import-preprocessor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbos%2Ffireflyiii-import-preprocessor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbos%2Ffireflyiii-import-preprocessor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbos%2Ffireflyiii-import-preprocessor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cbos","download_url":"https://codeload.github.com/cbos/fireflyiii-import-preprocessor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cbos%2Ffireflyiii-import-preprocessor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274290830,"owners_count":25258155,"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-09-09T02:00:10.223Z","response_time":80,"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":[],"created_at":"2025-09-09T11:27:03.707Z","updated_at":"2025-10-15T12:35:38.455Z","avatar_url":"https://github.com/cbos.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# firefly-csv-preprocessor\n\nThis preprocessor is used to transform CSV files into a format that can be used by the Firefly CSV Importer.\nThe default CSV file from my bank has three problems:\n\n- The banking costs are booked weird, both source and destination account are the same. Firefly does not accept that.\n  This is solved by just clearing the destination account.\n- I have multiple accounts, the transfer transactions appear twice in the list. This is solved by skipping the transfer transactions on other accounts then main.\n- When Firefly did import earlier files, the account name for 'payment providers' was set. But due to that, it is sometimes hard to see for which party the payment was made. \n  I solved this by creating an additional column. In the import that extra column is added to the note.\n\n## How to use this tool?\n\n- Build the native executable as described below.\n- Run the executable\n\n```shell\nalias firefly-csv-preprocessor='./target/firefly-csv-preprocessor-1.0.0-SNAPSHOT-runner'\n\ncp ./target/firefly-csv-preprocessor-1.0.0-SNAPSHOT-runner $HOME/.local/bin/firefly-csv-preprocessor\n\nfirefly-csv-preprocessor -i input.csv \\\n                         -o output.csv \\\n                         -ca \"IBAN/BBAN\" \\\n                         -cda \"Tegenrekening IBAN/BBAN\" \\\n                         -cn \"Naam tegenpartij\" \\\n                         -ncn \"Originele naam tegenpartij\" \\\n                         -m \"NL..ACOUNTNUMBER\"\n\n```\n\n\n\n\n# Quarkus - firefly-csv-preprocessor \n\nThis project uses Quarkus, the Supersonic Subatomic Java Framework.\n\nIf you want to learn more about Quarkus, please visit its website: \u003chttps://quarkus.io/\u003e.\n\n## Running the application in dev mode\n\nYou can run your application in dev mode that enables live coding using:\n\n```shell script\n./mvnw quarkus:dev\n```\n\n\u003e **_NOTE:_**  Quarkus now ships with a Dev UI, which is available in dev mode only at \u003chttp://localhost:8080/q/dev/\u003e.\n\n## Packaging and running the application\n\nThe application can be packaged using:\n\n```shell script\n./mvnw package\n```\n\nIt produces the `quarkus-run.jar` file in the `target/quarkus-app/` directory.\nBe aware that it’s not an _über-jar_ as the dependencies are copied into the `target/quarkus-app/lib/` directory.\n\nThe application is now runnable using `java -jar target/quarkus-app/quarkus-run.jar`.\n\nIf you want to build an _über-jar_, execute the following command:\n\n```shell script\n./mvnw package -Dquarkus.package.jar.type=uber-jar\n```\n\nThe application, packaged as an _über-jar_, is now runnable using `java -jar target/*-runner.jar`.\n\n## Creating a native executable\n\nYou can create a native executable using:\n\n```shell script\n./mvnw package -Dnative\n```\n\nOr, if you don't have GraalVM installed, you can run the native executable build in a container using:\n\n```shell script\n./mvnw package -Dnative -Dquarkus.native.container-build=true\n```\n\nYou can then execute your native executable with: `./target/firefly-csv-preprocessor-1.0.0-SNAPSHOT-runner`\n\nIf you want to learn more about building native executables, please consult \u003chttps://quarkus.io/guides/maven-tooling\u003e.\n\n## Related Guides\n\n- Picocli ([guide](https://quarkus.io/guides/picocli)): Develop command line applications with Picocli\n\n## Provided Code\n\n### Picocli Example\n\nHello and goodbye are civilization fundamentals. Let's not forget it with this example picocli application by changing the \u003ccode\u003ecommand\u003c/code\u003e and \u003ccode\u003eparameters\u003c/code\u003e.\n\n[Related guide section...](https://quarkus.io/guides/picocli#command-line-application-with-multiple-commands)\n\nAlso for picocli applications the dev mode is supported. When running dev mode, the picocli application is executed and on press of the Enter key, is restarted.\n\nAs picocli applications will often require arguments to be passed on the commandline, this is also possible in dev mode via:\n\n```shell script\n./mvnw quarkus:dev -Dquarkus.args='Quarky'\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcbos%2Ffireflyiii-import-preprocessor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcbos%2Ffireflyiii-import-preprocessor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcbos%2Ffireflyiii-import-preprocessor/lists"}