snowskeleton / ynam

Mint-to-YNAB translator
Apache License 2.0
38 stars 0 forks source link

Abstract

ynam is a commandline utility to import transactions from an Apple Card into YNAB. ynam achieves this by using an intermediary, namely Intuit's Mint, who happens to be able to import Apple Card transactions. ~~For some reason, this is easier than simply linking an Apple Card directly to YNAB. If you're a developer from either one of these companies, please make this project obsolete.~~ The wait is finally over! YNAB now natively supports Apple Wallet accoutns, including Apple Card, Apple Cash, and Apple Savings! See full details here https://www.ynab.com/blog/ynab-apple-wallet

Prerequisites

To test it out, simply run

ynam

The first run can take up to a minute to complete. Run with -x to see what's happening!

Docker

First complete the --quickstart process, passing ynam's config directory as a volume mount.

docker run -v "$HOME/.ynam:/root/.ynam" -it snowskeleton/ynam --quickstart

Subsequent runs should use:

docker run -v "$HOME/.ynam:/root/.ynam" -it -d snowskeleton/ynam

Note the inclusion of -d, which runs the image in detached mode.

Run with your preferred scheduler. I use cron.

Considerations

Importing Transactions

Avoid manually entering your Apple Card transations ynam can sometimes detect that you manually enterd a charge and not overwrite it, but not in all cases. ynam adds a unique ID to each transaction it imports, so it will never duplicate its own transactions

Structure of config file

ynam requires a few pieces of info to do its job. Specifically, it requires:

Closing

I hope you find ynam useful!

Feel free to open an Issue or Pull Request with any new ideas or problems.

Disclaimer

This project is neither associated with, nor endorsed by, YNAB, Intuit (or its subsidiary Mint), or Apple. All rights belong to original creators.