My-py-Finance-Manager

A Python script aimed at making the process of managing finances simple. The script parses gmail inboxes using Python's gmail API to find deposit alerts and then generates a pie chart showing your personalized budget breakdown which is saved to a desired file location for future reference.

Setup

• You will need to allow access to your google account for less secure apps so the parser can have access to your gmail inbox

  • Navigate to Google account settings (not gmail settings) -> Security -> less secure app access (shown below)

• Within your PNC bank account, turn on deposit email notifications

  • Navigate to Alerts -> Alerts Profile -> turn on "Direct deposit greater than $1.00" email notifications

• Update the following variables to match your account/preferences:

# email info
EMAIL_ADR = 'YOUR EMAIL HERE'
EMAIL_PWD = 'YOUR PASSWORD HERE'

# categories can be changed/added/deleted as long as values add up to 1.0.
# for each category added/deleted, you must also add/delete a color located
# under graph info
savings_categories = {'College Funds': .75, 'Savings': .2, 'Spending': .05}

# graph info
colors = ['#ff9999', '#66b3ff', '#99ff99']

# saving pie chart to entered filepath as pdf named as the current date (Ex: Jul05.pdf)
# example file location: 'home/your/directory/'
plt.savefig("ENTER DESIRED FILE LOCATION" + datetime.date.today().strftime("%b%d") + ".pdf", bbox_inches="tight"

Usage

• After updating the variables specified above, simply run the python script, enter the desired amount of days you would like to parse, and wait for your visualization to pop up! You will then be able to access this .pdf of your vizualization from the file location you specified above.

Example Visualization

License

GPL-3.0