This is an alpha version. Use at your own risk. I suggest backing up your budget first.

What's this?

YNAB is excellent budgeting software, but it an it API are missing some essential features.

This repo aims to provide those additional APIs, in part by using Selenium to automate interactions with the YNAB webpage as needed.

1. Backup and restore your budget
2. Split Amazon transactions into individual, labeled items
3. API for adding/modifying split transactions
4. Delete transactions

Work in progress:

5. Automatic distribution of funds to meet category goals
6. Goals on a specific date

Installation:

Clone the repo:

mkdir $YOUR_CHOICE_OF_DIRECTORY_NAME  
cd $YOUR_CHOICE_OF_DIRECTORY_NAME
git clone http://github.com/dmlerner/assistantforynab.git
cd assistantforynab

Optionally, make a virtual environment:

python3 -m venv env
source ./env/bin/activate

Install:

python3 setup.py install

Use:

source $YOUR_CHOICE_OF_DIRECTORY_NAME/env/bin/activate
python3

>>> import assistantforynab as afy
>>> afy.settings.set('account_name', 'Chase Amazon')
>>> afy.Assistant.full_handle_amazon()
>>> afy.settings.show()

deactivate

For more ideas of what it can do, check out assistantforynab.assistant.py or the tests directory

FAQ:

1. Does this jeopardize my credentials or YNAB data? No. It uses the official YNAB API and goes through the same servers as if you use the webapp. I generated Python binding from the official swagger spec using OpenAPI Generator, and made zero modifications.

2. Does this store my data? Yes, but only on whatever computer you use to run it. This is for backup purposes, and easy to disable.

3. Why does this ask for my API Token? Because it's an alpha version and I haven't gotten around to making it work with OAuth. The token is sent to YNAB, but not to anywhere else.

4. What operating systems does this work on? I have developed it on windows with WSL and cmder. I like, think it might work on mac/linux/normal windows too. Let me know...