mm

money-man

Setup a basic budget with your recurring payments and manage your cashflow

Showing:

Popularity

Downloads/wk

1

GitHub Stars

0

Maintenance

Last Commit

4yrs ago

Contributors

0

Package

Dependencies

5

Size (min+gzip)

27.0KB

License

GPL-3.0-or-later

Type Definitions

Tree-Shakeable

No?

Categories

Readme

money-man

A CLI personal financing tool for cash flow simulation, forecasting, budgeting and debt payoff planning

screen shot 2017-09-26 at 11 51 01 pm

Install

  • npm install -g money-man or
  • npx money-man
  • Create your own data.json file following the sample below
  • Execute with money-man -i /path-to-your-own/data.json to run a month long simulation
  • Execute with money-man -i /path-to-your-own/data.json -m 12 to run a year long simulation

Features

CLI Options

  Usage: money-man [options]

  Options:

    -V, --version              output the version number
    -i, --input <path>         Specify relative or absolute input data file path
    -m, --months <noOfMonths>  Specify number of months to simulate
    -h, --help                 output usage information

Sample Input Data

{
  "accounts": [
    {
      "name": "Checking",
      "balance": 555.55,
      "minBalance": 50
    },
    {
      "name": "Savings",
      "balance": 995.95,
      "minBalance": 300
    },
    {
      "name": "PiggyBank",
      "balance": 500.01,
      "minBalance": 0
    },
    {
      "name": "Credit",
      "balance": 0,
      "minBalance": 0
    }
  ],
  "recurringEvents": [
    {
      "name": "Acme Co",
      "recurrence": "FREQ=MONTHLY;BYMONTHDAY=1,15",
      "amount": 2000,
      "target": "Checking",
      "type": "Income"
    },
    {
      "name": "Acme Bank",
      "type": "Expenditure",
      "category": "Mortgage",
      "source": "Savings",
      "recurrence": "FREQ=MONTHLY;COUNT=360;BYMONTHDAY=11",
      "startDate": "2017-01-01T05:00:00Z",
      "amount": 1534.13
    },
    {
      "name": "Acme Bank",
      "type": "Transfer",
      "source": "Checking",
      "target": "Savings",
      "recurrence": "FREQ=MONTHLY;COUNT=360;BYMONTHDAY=11",
      "startDate": "2017-01-01T05:00:00Z",
      "amount": 1534.13
    },
    {
      "name": "Water",
      "type": "Expenditure",
      "category": "Utility",
      "source": "Checking",
      "recurrence": "FREQ=MONTHLY;INTERVAL=3;BYMONTHDAY=15",
      "startDate": "2017-08-15T05:00:00Z",
      "amount": 200
    },
    {
      "name": "Gas Nov-Apr",
      "type": "Expenditure",
      "category": "Utility",
      "source": "Checking",
      "recurrence": "FREQ=YEARLY;BYMONTH=11,12,1,2,3,4;BYMONTHDAY=1",
      "startDate": "2017-04-03T05:00:00Z",
      "amount": 100
    },
    {
      "name": "Gas May-Oct",
      "type": "Expenditure",
      "category": "Utility",
      "source": "Checking",
      "recurrence": "FREQ=YEARLY;BYMONTH=5,6,7,8,9,10;BYMONTHDAY=1",
      "startDate": "2017-09-01T05:00:00Z",
      "amount": 50
    },
    {
      "name": "Some subscription",
      "type": "Expenditure",
      "category": "Subscriptions",
      "source": "Credit",
      "recurrence": "FREQ=MONTHLY;BYMONTHDAY=21",
      "startDate": "2017-08-15T05:00:00Z",
      "amount": 9.99
    }
  ]
}

TODO

  • Recurring transfers between accounts
  • Credit card balance, interest rate and minimum payment tracking
  • CSV import/export & Excel templates that graph the exported data
  • Persistant database-based operations and snapshot updates based on user input
  • A UI(unlikely)
  • Live connection to bank account to pull latest balances (very unlikely, unless this becomes a commerical product)

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100