{"id":29200301,"url":"https://github.com/zmoog/ynabkit","last_synced_at":"2025-10-26T23:42:13.703Z","repository":{"id":182490733,"uuid":"668563509","full_name":"zmoog/ynabkit","owner":"zmoog","description":"YNAB tools to import and analyze financial data","archived":false,"fork":false,"pushed_at":"2024-11-04T00:02:42.000Z","size":29,"stargazers_count":0,"open_issues_count":6,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-06-28T06:03:18.129Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zmoog.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}},"created_at":"2023-07-20T05:33:17.000Z","updated_at":"2024-11-04T00:02:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"f11c7b8a-94d6-48db-bf97-d565885f5fa6","html_url":"https://github.com/zmoog/ynabkit","commit_stats":null,"previous_names":["zmoog/ynab"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/zmoog/ynabkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmoog%2Fynabkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmoog%2Fynabkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmoog%2Fynabkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmoog%2Fynabkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zmoog","download_url":"https://codeload.github.com/zmoog/ynabkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zmoog%2Fynabkit/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263121439,"owners_count":23416997,"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":"2025-07-02T10:35:38.450Z","updated_at":"2025-10-26T23:42:13.627Z","avatar_url":"https://github.com/zmoog.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ynabkit\n\n[![PyPI](https://img.shields.io/pypi/v/ynabkit.svg)](https://pypi.org/project/ynabkit/)\n[![Changelog](https://img.shields.io/github/v/release/zmoog/ynabkit?include_prereleases\u0026label=changelog)](https://github.com/zmoog/ynabkit/releases)\n[![Tests](https://github.com/zmoog/ynabkit/workflows/Test/badge.svg)](https://github.com/zmoog/ynabkit/actions?query=workflow%3ATest)\n[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/zmoog/ynabkit/blob/master/LICENSE)\n\nYNAB Kit is a CLI tool to support data import and export from YNAB. It provides tools to convert data from Fineco, N26, and Satispay export files to YNAB CSV format.\n\n## Installation\n\nInstall this tool using `pip`:\n\n    pip install ynabkit\n\n## Usage\n\n### Fineco Bank\n\nConvert Fineco bank export files to YNAB format:\n\n```bash\n# Basic conversion\nynabkit fineco describe-transactions input.xlsx\n\n# With payee configuration\nynabkit fineco describe-transactions input.xlsx --payees payees.yml\n```\n\n### N26 Bank\n\nConvert N26 bank export files to YNAB format:\n\n```bash\n# Basic conversion\nynabkit n26 describe-transactions input.csv\n\n# With payee configuration\nynabkit n26 describe-transactions input.csv --payees payees.yml\n```\n\n### Satispay\n\nConvert Satispay export files to YNAB format:\n\n```bash\n# Basic conversion\nynabkit satispay describe-transactions input.csv\n\n# Exclude specific transaction types\nynabkit satispay describe-transactions input.csv --exclude-kinds \"Ricarica,Prelievo\"\n\n# With payee configuration\nynabkit satispay describe-transactions input.csv --payees payees.yml\n```\n\n### Payee Configuration\n\nCreate a `payees.yml` file to map transaction descriptions to specific payees:\n\n```yaml\n- name: Amazon\n  patterns:\n  - \"AMAZON\"\n  - \"AMAZON.*\"\n- name: Spotify\n  patterns:\n  - \"SPOTIFY\"\n- name: Local Supermarket\n  patterns:\n  - \".*SUPERMARKET.*\"\n  - \"CONAD\"\n  - \"COOP\"\n```\n\nFor help with any command, run:\n\n    ynabkit --help\n\nYou can also use:\n\n    python -m ynabkit --help\n\n## Development\n\nTo contribute to this tool, first checkout the code. Then create a new virtual environment:\n\n    cd ynabkit\n    python -m venv venv\n    source venv/bin/activate\n\nNow install the dependencies and test dependencies:\n\n    pip install -e '.[test]'\n\nTo run the tests:\n\n    pytest\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzmoog%2Fynabkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzmoog%2Fynabkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzmoog%2Fynabkit/lists"}