{"id":19922548,"url":"https://github.com/sa7mon/firefly-gone-plaid","last_synced_at":"2025-06-21T08:40:00.389Z","repository":{"id":84343623,"uuid":"261305997","full_name":"sa7mon/firefly-gone-plaid","owner":"sa7mon","description":"A connector to add financial transactions from the Plaid API to Firefly III","archived":false,"fork":false,"pushed_at":"2020-12-03T02:14:03.000Z","size":18,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-18T04:49:29.155Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sa7mon.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2020-05-04T22:06:17.000Z","updated_at":"2025-01-04T03:12:30.000Z","dependencies_parsed_at":"2023-07-06T22:15:57.545Z","dependency_job_id":null,"html_url":"https://github.com/sa7mon/firefly-gone-plaid","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sa7mon/firefly-gone-plaid","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sa7mon%2Ffirefly-gone-plaid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sa7mon%2Ffirefly-gone-plaid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sa7mon%2Ffirefly-gone-plaid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sa7mon%2Ffirefly-gone-plaid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sa7mon","download_url":"https://codeload.github.com/sa7mon/firefly-gone-plaid/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sa7mon%2Ffirefly-gone-plaid/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261095027,"owners_count":23108758,"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":[],"created_at":"2024-11-12T22:11:27.355Z","updated_at":"2025-06-21T08:39:55.379Z","avatar_url":"https://github.com/sa7mon.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Firefly Gone Plaid\n\nA connector to add financial transactions from the Plaid API to [Firefly III](https://github.com/firefly-iii/firefly-iii)\n\n\u003cp align=\"center\"\u003e\n\u003cimg width=\"480\" height=\"260\" src=\"https://user-images.githubusercontent.com/3712226/84401910-7355cb00-abc9-11ea-92f4-3be6fa398f7a.png\"\u003e\u003cbr /\u003e\"Firefly.....it's gone Plaid!\"\n\u003c/p\u003e\n\n## Usage\n\n**Standalone**\n\n```\ngo build -o firefly-gone-plaid\n./firefly-gone-plaid --config config.json --start-date 2020-06-10 --end-date 2020-06-20\n```\n\n**Docker**\n\n```bash\ndocker build . -t hothamandcheese/firefly-gone-plaid:latest\ndocker run --rm -v $(pwd)/config:/config:ro hothamandcheese/firefly-gone-plaid:latest --config /config/config.json --start-date 2020-05-15 --end-date 2020-06-11\n```\n\n## Config\n\nBefore running the tool, you'll need to:\n\n0. Generate a Personal Access Token in Firefly III (Options \u003e Profile \u003e Create new token)\n1. Create Plaid account\n2. Use the [Plaid Quickstart](https://github.com/plaid/quickstart) to connect your bank accounts to your Plaid account and get your Plaid `access-development-X` tokens\n3. Create a `config.json` file that follows this basic schema:\n\n```json\n{\n  \"firefly_api_base_url\": \"http://ip.or.hostname.of.firefly:port\",\n  \"firefly_token\": \"XXXXXXXXXXX\",\n  \"plaid_client_id\": \"XXXXXXXXXX\",\n  \"plaid_secret\": \"XXXXXXXXXXXXXX\",\n  \"plaid_public_key\": \"XXXXXXXXXXXXXX\",\n  \"connections\": [\n    {\n      \"token\": \"access-development-XXXXX-XXXXXXXX\",\n      \"institution_nickname\": \"US Bank\",\n      \"accounts\": [\n        {\n          \"firefly_account_id\": 1,\n          \"account_last_four\": \"1111\",\n          \"account_nickname\": \"US Bank Savings\"\n        },\n        {\n          \"firefly_account_id\": 3,\n          \"account_last_four\": \"2222\",\n          \"account_nickname\": \"US Bank Checking\"\n        }\n      ]\n    },\n    {\n      \"token\": \"access-development-XXXXXXX-XXXXXXXXX\",\n      \"institution_nickname\": \"Discover\",\n      \"accounts\": [\n        {\n          \"firefly_account_id\": 7,\n          \"account_last_four\": \"4567\",\n          \"account_nickname\": \"Discover\"\n        }\n      ]\n    }\n  ]\n}\n```\n\n**Note:**\n* All \"*_nickname\" fields can be set to anything. The names will only be used in logs.\n* The `firefly_account_id` must be an ID of a Firefly asset account. Expense and revenue accounts do not currently work.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsa7mon%2Ffirefly-gone-plaid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsa7mon%2Ffirefly-gone-plaid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsa7mon%2Ffirefly-gone-plaid/lists"}