Mint Sankey

Version Build Status

mint-sankey is a tool that will take your Mint transactions, combine it with your paycheck info, and dump text data out so that SankeyMatic can read it.

You can see an example input file in data/test-data.csv, which will generate output like so:

Wages [197] Federal Income Tax
Wages [32] Social Security
Wages [755] Take Home
Take Home [105] Hotel
Take Home [35] Income
Take Home [32] Restaurants
Take Home [24] Groceries
Take Home [24] Gas & Fuel
Take Home [535] Savings

You can then copy-paste this away into SankeyMatic and get the following plot:

SankeyMatic sample data

There's also a flag in the config to use_percentages, which will output relative, not absolute values. It's a little buggy as I go back and forth on whether or not I want to noramlize by level or to the "global" input. Maybe it'll help you!

Getting Started


Using the tool requires Python 3.6 or higher.

Go to Mint and download your transaction history to the data/ folder. The default name used is transactions.csv.


Clone the repo and install the requirements:

pip install -r requirements.txt

Copy config-sample.toml to config.toml and edit away.


Run the tool with python The default output file is output.txt. Copy the contents of that file into SankeyMatic and enjoy!

Style & Formatting

I use:

  • yapf for formatting
  • flake8 for linting
  • pyre for type checking

In general, I try to be yapf and flake8 issue free, and minimize as many errors as possible from pyre. Once the errors start showing up as a result of other (pip-installed) modules, I punt on them. To use these, run:

pip install -r requirements-dev.txt
pyre init


Do what you want, see


Mint Sankey

generate Sankey diagrams from Mint budgets

Mint Sankey Info

⭐ Stars 12
🔗 Source Code
🕒 Last Update a year ago
🕒 Created 3 years ago
🐞 Open Issues 0
➗ Star-Issue Ratio Infinity
😎 Author bradysalz