Git Product home page Git Product logo

monarch-backfill-balance-history-from-transactions's Introduction

Monarch-Backfill-Balance-History-From-Transactions

The goal of this script is to backfill the balance history of Monarch money accounts based on an exported transaction history.

Installation

This program requires Python 3 to be installed on your system and added to your path. https://www.python.org/downloads/

If you have git installed, use the command:

git clone https://github.com/ChrisQGeorge/Monarch-Backfill-Balance-History-From-Transactions.git

Otherwise, download the Zip file by hitting the "code" button and clicking "download zip" and then extract

Setup

To import monarch transactions

  1. Import any transactions into the account in Monarch
  2. Export the transactions using the "Edit" dropdown and clicking "Download Transactions"
  3. Place the file in the "import" directory
  4. run the main.py file with the command "python main.py" in the terminal in the project directory
  5. Follow the instructions in the terminal
  6. When the instructions prompt for an account value, please put the actual value of the account (positive for asset, negative for liability) rather than the absolute value
  7. A generated file will appear in the "Export" directory
  8. Go to the account in Monarch, hit the edit button, click "Upload Balance History" and select the generated file
  9. You're done!

To import Mint trends balance history

  1. Go to the trends tab in Mint
  2. Select the assets or debts tab and select a particular account
  3. Go to the bottom of the page and click the "Export to CSV" button
  4. Move the file to the "Import" directory
  5. run the main.py file with the command "python main.py" in the terminal in the project directory
  6. Follow the instructions in the terminal
  7. A generated file will appear in the "Export" directory
  8. Go to the account in Monarch, hit the edit button, click "Upload Balance History" and select the generated file
  9. You're done!

Note: You may find that the balances go into the negative or otherwise being incorrect. This is most likely caused by duplicate transactions or incorrect transactions. To fix this, you will need to clean your transaction history, and you can use the balances as an indicator of where to look. Remember that this will start at the newest transaction and work backward, so if you have a bad balance at a given date, look for transactions after that date.

monarch-backfill-balance-history-from-transactions's People

Contributors

chrisqgeorge avatar tekgeorge avatar

Stargazers

mhlas7 avatar Jon Dyer avatar edfine avatar Habib Affinnih avatar Andy Vainauskas avatar Osman A. Osman avatar  avatar Jon Sutherland avatar  avatar

Watchers

 avatar

monarch-backfill-balance-history-from-transactions's Issues

Doesn't generate an export file

I'm trying to use this and think I have everything setup correctly, but the script runs and I get no new files in my export folder. It doesn't throw any errors, but the Python window just closes.

Monarch API integration

Optionally use the Monarch API so that the user doesn't need to manually import and export transactions and balance histories. The API can handle requests for transactions but not sure if it will allow balance importing.

Mint Compatability

Allow the importation of Mint transactions and convert it into a monarch balance history (Other apps as well such as YNAB or Rocket money?).

Enter negative balance for liability

Just some feedback, when asked for a current balance on a credit line/card, you need to put the value in as negative, otherwise the balances will import improperly. Thanks for the script.

Error on import for mint on Mac

I tried importing my Mint transaction data using terminal on Mac and received the following error. Is the app coded to expect Windows file paths? I have a transactions.csv file in the Imports directory.

rhewitt:Monarch-Backfill-Balance-History-From-Transactions rhewitt$ python3 main.py
Would you like to import from:
1.Monarch
2.Mint
e.Exit
:2
Would you like to:
1.Convert Mint trend account balances to Monarch balances
e.Exit
:1
Traceback (most recent call last):
  File "/Users/rhewitt/web/Monarch-Backfill-Balance-History-From-Transactions/main.py", line 210, in <module>
    menu()
  File "/Users/rhewitt/web/Monarch-Backfill-Balance-History-From-Transactions/main.py", line 194, in menu
    balances = importMintBalances()
  File "/Users/rhewitt/web/Monarch-Backfill-Balance-History-From-Transactions/main.py", line 93, in importMintBalances
    selection = selectImportFile(importDir)
  File "/Users/rhewitt/web/Monarch-Backfill-Balance-History-From-Transactions/main.py", line 41, in selectImportFile
    filenames = os.listdir(importDir)
FileNotFoundError: [Errno 2] No such file or directory: '/Users/rhewitt/web/Monarch-Backfill-Balance-History-From-Transactions\\import\\'

Import balance history from mint

Allow the script to create a backfill history from a mint trends history export. Might also be nice to just allow any generic balance history to be imported.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.