MindMyMoney User Guide

Content Page

Introduction
Quick start
Features
FAQ
Command summary (Expenditure)
Command summary (Credit Card)
Command summary (Income)

Introduction

MindMyMoney

MindMyMoney (M³) is a desktop application for managing your personal finances, optimized for use via a Command Line Interface (CLI). You can use it to track your expenditures across multiple payment methods, calculate monthly expenditure, and track your income. If you are a student looking to manage your personal finances, this application is for you!

Using the User Guide

This guide aims to equip you with the knowledge on how to set up the application and to utilise its many features. Click on the hyperlinks in the Content Page to quickly navigate the user guide! Along the guide you may encounter several icons. These icons will provide you with several useful information.

💡 Note:

This tells you that there is additional information that is useful when you are using the application.

⚠️Warning⚠️

This tells you that there is some important information you should take note of to prevent issues from arising when you are using the application.

Quick Start

Ensure that you have Java 11 or above installed. Click here for the link to the Java 11 installer.
Download the latest version of MindMyMoney.jar from here.
Copy the file to the folder you want to use as the home folder for your MindMyMoney.
Open a command line terminal in your home folder and run java -jar MindMyMoney.jar. The startup interface similar to the one below should appear in a few seconds.

 __  __ _         _ __  __      __  __
|  \/  (_)_ _  __| |  \/  |_  _|  \/  |___ _ _  ___ _  _
| |\/| | | ' \/ _` | |\/| | || | |\/| / _ \ ' \/ -_) || |
|_|  |_|_|_||_\__,_|_|  |_|\_, |_|  |_\___/_||_\___|\_, |
                           |__/                     |__/
<< Set a budget and stick to it >>

Welcome to MindMyMoney
What can I do for you?

Type the command in the command box and press Enter to execute it. For example: typing help and pressing Enter will show a help page.
Some example commands you can try:
- add/e /pm cash /c Food /d Porridge /a 3 /t 12/03/2022 : Adds a $3 expenditure of the description ‘Porridge’ that was paid in cash on 12 March 2022 to your list of expenditures.
- list /e : Lists all expenditures.
- calculate/epm 03/2022 : Calculates the total expenditure in the month of March 2022.
- update/e 1 /pm cash /c Food /d Chicken Rice /a 4.50 /t 12/03/2022 : Updates the first expenditure on your expenditure list to reflect a $4.50 expenditure of the description ‘Chicken Rice’ that was paid in cash on 12 March 2022.
- delete/e 1 : Deletes the first expenditure in your expenditure list.
- bye : Exits the application.
Refer to the Features for more details of each command.

Features

The following are features of the MindMyMoney application.

Introduction to Commands

A MindMyMoney command typically contains 4 types of terms.

The first term in the command is known as the instruction.
Terms in [SQUARE_BRACKETS] are compulsory parameters.
Terms in {CURLY_BRACKETS} are optional parameters.
Terms starting with a / are flags.

For Example:

list /e {DATE}
- list is an instruction, /e is a flag and {DATE} is an optional parameter.
calculate /epm [DATE]
- calculate is an instruction, /epm is a flag and [DATE] is a compulsory parameter.

💡 Note:

Parameters and flags are space-separated. For example: list/e is not a valid command while list /e is valid.

⚠️Warning⚠️

Input the parameters in the order shown in the guide, else the application will not be able to read your input.

Only use ASCII characters when entering commands into the application. Otherwise, your input may not be properly displayed in the command line.

Expenditure

Expenditure refers to the various expenses you make.

Display help page for expenditures: `help`

Prints a list of commands related to expenditure.

Format: `help /e`

Expected Outcome:

For example: help /e
Shows the help page for expenditure related commands.

> help /e
---------------------------------------Expenditure Help Page---------------------------------------
1. Listing all Expenditures: list /e {DATE}
2. Adding an Expenditure entry: add /e /pm [PAYMENT_METHOD] /c [CATEGORY] /d [DESCRIPTION] /a [AMOUNT] /t [DATE]
3. Calculating the total expenditure in a month: calculate /epm [DATE]
4. Updating an Expenditure: update /e [NEW_INDEX] /pm [NEW_PAYMENT_METHOD] /c [NEW_CATEGORY] /d [NEW_DESCRIPTION] /a [NEW_AMOUNT] /t [NEW_DATE]
5. Removing an Expenditure entry: delete /e [INDEX]
6. Exiting the program: bye
---------------------------------------------------------------------------------------------------

Add an expenditure: `add`

Adds an expenditure into your expenditure list. Only one expenditure can be added per command.

Format: `add /e /pm [PAYMENT_METHOD] /c [CATEGORY] /d [DESCRIPTION] /a [AMOUNT] /t [DATE]`

[PAYMENT_METHOD] refers to the method of payment used.
- Enter cash or the name of a credit card you have saved.
[CATEGORY] refers to the supported categories of expenditure.
- Enter Food, Transport, Utilities, Personal, Entertainment or Others.
[DESCRIPTION] refers to the description of the expenditure.
- For example: Porridge.
[AMOUNT] refers to the cost of the expenditure.
- Enter the amount in dollars, rounded off to the nearest cent.
- For example: an item that cost $420.69 will be entered as 420.69.
[DATE] refers to the date of the purchase of the expenditure.
- Format of the date is dd/mm/yyyy.
- For example: 12 March 2022 will be entered as 12/03/2022.

Expected Outcome:

For example: add /e /pm cash /c Food /d Porridge /a 4.50 /t 12/03/2022
Adds a $4.50 expenditure of food item ‘Porridge’ that was paid in cash on 12 March 2022 to your expenditure list.

> add /e /pm cash /c Food /d Porridge /a 4.50 /t 12/03/2022
Successfully added: 

Description: Porridge
Amount: $4.50
Category: Food
Payment method: Cash
Date: 12/03/2022

into the account

💡 Note:

[CATEGORY] and [PAYMENT_METHOD] are case-insensitive.

Your credit card has to be added first before entering the name of the credit card as [PAYMENT_METHOD].

[AMOUNT] only accepts numbers with 2 decimal places. Any additional decimals will be rounded off or ignored.

Maximum [AMOUNT] allowed for user is 1000000 ($1 million).

⚠️Warning⚠️

[CATEGORY]: Any input that is not Food, Transport, Utilities, Personal, Entertainment or Others will be rejected.

[DATE] not in the format of dd/mm/yyyy will be rejected.

Input dates later than the current date will be rejected.

Illogical input dates will be rejected.

Display expenditures: `list`

Prints your current list of expenditures.

Format: `list /e {DATE}`

{DATE} refers to the date of the expenditures you would like to view.
- Enter the {DATE} in dd/mm/yyyy, mm/yyyy or yyyy format.

Expected Outcome:

For example: list /e
Lists all your expenditures.

> list /e
-----------------------------------------------
1. $300.00 was spent on Nike Shoes(Personal) using Cash [30/03/2022]
2. $20.00 was spent on Grab(Transport) using Cash [30/03/2022]
3. $3.21 was spent on Bubble Tea(Food) using Cash [30/01/1999]
4. $4.50 was spent on Porridge(Food) using Cash [12/03/2022]
-----------------------------------------------

For example: list /e 03/2022
Lists all your expenditures in March 2022.

> list /e 03/2022
-----------------------------------------------
1. $300.00 was spent on Nike Shoes(Personal) using Cash [30/03/2022]
2. $20.00 was spent on Grab(Transport) using Cash [30/03/2022]
3. $4.50 was spent on Porridge(Food) using Cash [12/03/2022]
-----------------------------------------------

For example: list /e 30/03/2022
Lists all your expenditures in 30 March 2022.

> list /e 30/03/2022
-----------------------------------------------
1. $300.00 was spent on Nike Shoes(Personal) using Cash [30/03/2022]
2. $20.00 was spent on Grab(Transport) using Cash [30/03/2022]
-----------------------------------------------

💡 Note:

list /e will show you all expenditures stored in the list.

⚠️Warning⚠️

{DATE} not in the format of dd/mm/yyyy, mm/yyyy or yyyy will be rejected.

Before entering the command, an expenditure with the same input date must exist in the expenditure list.

Modify an expenditure: `update`

Modifies an expenditure on your expenditure list at the specified index.
Use the list /e command to view the indexes of your expenditures.

Format: `update /e [INDEX] /pm [NEW_PAYMENT_METHOD] /c [NEW_CATEGORY] /d [NEW_DESCRIPTION] /a [NEW_AMOUNT] /t [NEW_DATE]`

[INDEX] refers to the index of expenditure in list in which you want to update.
- Enter 1 if you want to update the first expenditure in your list.
[NEW_PAYMENT_METHOD] refers to the new method of payment used.
- Enter cash or the name of a credit card you have saved.
[NEW_CATEGORY] refers to the new category of the expenditure.
- Enter Food, Transport, Utilities, Personal, Entertainment or Others.
[NEW_DESCRIPTION] refers to the new description of the expenditure.
- For example: Chicken rice.
[NEW_AMOUNT] refers to the updated of the expenditure.
- Enter the amount in dollars, rounded off to the nearest cent.
- For example: an item that cost $420.69 will be entered as 420.69.
[NEW_DATE] refers to the new date of the purchase of the expenditure.
- Format of the date is dd/mm/yyyy.
- For example: 12 March 2022 will be entered as 12/03/2022.

Expected Outcome:

For example: update /e 1 /pm cash /c Food /d chicken rice /a 5 /t 12/03/2022.
Updates the first expenditure in your list to a $5.00 expenditure on food item ‘chicken rice’ that was paid in cash on 12 March 2022.

> list /e
-----------------------------------------------
1. $300.00 was spent on Nike Shoes(Personal) using Cash [30/03/2022]
2. $20.00 was spent on Grab(Transport) using Cash [30/03/2022]
3. $3.21 was spent on Bubble Tea(Food) using Cash [30/01/1999]
4. $4.50 was spent on Porridge(Food) using Cash [12/03/2022]
-----------------------------------------------

> update /e 4 /pm cash /c Food /d chicken rice /a 5 /t 12/03/2022
Successfully set expenditure 4 to:
$5.00 was spent on chicken rice(Food) using Cash [12/03/2022]

💡 Note:

This command is similar to the add an expenditure command.

Parameters that are labeled starting with NEW follow the same restrictions in add an expenditure.

For example: [NEW_CATEGORY] is case-insensitive, similar to [CATEGORY]

[INDEX] is based on the list generated from list /e, not the other variations of list /e {DATE}.

Only enter [INDEX] that exist in the expenditure list. For example: if you have 4 expenditures in your list, specify [INDEX] to be a number from 1 to 4.

⚠️Warning⚠️

[NEW_CATEGORY]: Any input not in the accepted list of categories will be rejected.

[NEW_DATE] not in the format of dd/mm/yyyy will be rejected.

Input dates later than the current date will be rejected.

Remove an expenditure: `delete`

Deletes an expenditure from your expenditure list at the specified index.
Use the list /e command to view the current indexes of your expenditures.

Format: `delete /e [INDEX]`

[INDEX] refers to the index of expenditure in list in which you want to delete.

Expected Outcome:

For example: delete /e 1
Deletes the first expenditure on your list.

> list /e
-----------------------------------------------
1. $300.00 was spent on Nike Shoes(Personal) using Cash [30/03/2022]
2. $20.00 was spent on Grab(Transport) using Cash [30/03/2022]
3. $3.21 was spent on Bubble Tea(Food) using Cash [30/01/1999]
4. $4.50 was spent on Porridge(Food) using Cash [12/03/2022]
-----------------------------------------------

> delete /e 1
I have removed Nike Shoes of $300.00 from the account

💡 Note:

Only enter [INDEX] that exist in your list. For example: if you have 4 expenditures in your list, specify [INDEX] to be a number from 1 to 4.

[INDEX] is based on the list generated from list /e, not the other variations of list /e {DATE}.

Do not use delete /e when your expenditure list is empty.

Calculate expenditures: `calculate`

Shows the total expenditure breakdown for a specified day, month or year in a horizontal bar chart.

Format: `calculate /epm [DATE]`

[DATE] can be of the format dd/mm/yyyy, mm/yyyy or yyyy, depending on the duration you are interested in.

Expected Outcome:

For example: calculate /epm 03/2022
Shows your total expenditure in March 2022 and breakdown of expenses.

> calculate /epm 03/2022
Total expenditure in 03/2022 is $24.50.

BREAKDOWN OF EXPENSES:
-----------------------------------------------
FOOD:          $$$$$$$$ [18.37%]
TRANSPORT:     $$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$$ [81.63%]
UTILITIES:      [0.0%]
PERSONAL:       [0.0%]
ENTERTAINMENT:  [0.0%]
OTHERS:         [0.0%]
-----------------------------------------------

💡 Note

An error will be shown if the date that you would like to calculate is not found in the expenditure list.

Credit Card

Credit card refers to the various credit cards you might have.

Display help page for credit cards: `help`

Prints a list of commands related to credit card.

Format: `help /cc`

Expected Outcome:

For example: help /cc
Shows the help page for credit card related commands.

> help /cc
---------------------------------------Credit Card Help Page---------------------------------------
1. Listing all Credit Cards: list /cc
2. Adding a Credit Card: add /cc /n [CREDIT_CARD_NAME] /cb [CASHBACK] /cl [CREDIT_LIMIT]
3. Updating a Credit Card: update /cc [INDEX] /n [NEW_NAME] /cb [NEW_CASHBACK] /cl [NEW_CREDIT_LIMIT]
4. Removing a credit card: delete /cc [INDEX]
5. Exiting the program: bye
---------------------------------------------------------------------------------------------------

Add a credit card: `add`

Adds a credit card into your credit card list. Only one credit card can be added per command. You can then use this credit card as a payment method when adding an expenditure.

Format: `add /cc /n [CREDIT_CARD_NAME] /cb [CASHBACK] /cl [CARD_LIMIT]`

[CREDIT_CARD_NAME] refers to the name your Credit Card will be saved as.
- Use abbreviations for ease of adding expenditures to this credit card. For example: storing DBS Live Fresh Credit Card as DBS LF.
[CASHBACK] refers to the amount of cash back received when spending on the credit card.
- Enter the amount of cashback in percentage.
- For example: a credit card with 2% cashback can be represented as /cb 2.
[CARD_LIMIT] refers to the maximum monthly expenditure on this credit card.
- Enter the monthly maximum amount that can be spent on the credit card in dollars.

Expected Outcome:

For example:add /cc /n dbs /cb 2 /cl 1000
Adds your credit card of the name ‘DBS’ with a cashback of 2% and a monthly spending limit of $1000.

> add /cc /n dbs /cb 2 /cl 1000
Successfully added: 

Credit card: dbs
Cash back: 2.00%
Card limit: $1000.00

into the account

💡 Note

[CREDIT_CARD_NAME] is case-insensitive.

⚠️Warning⚠️

[CREDIT_CARD_NAME] cannot be cash, CASH, or a combination of either.

You are not allowed to add 2 credit cards with the same in [CREDIT_CARD_NAME]. Instead, you can abbreviate the cards differently.

For example: If you have two DBS credit cards, you can enter the [CREDIT_CARD_NAME] of the first card to be DBS_one and the other as DBS_two.

[CASHBACK] cannot be more than 100%.

[CARD_LIMIT] cannot be more than $40,000. Generally, students should not have a monthly income of more than $10,000, and hence a monthly credit card limit of $40,000 calculated through here.

Display credit cards: `list`

Prints your current list of credit cards.

Format: `list /cc`

Expected Outcome:

For example: list /cc
Lists all your credit cards.

> list /cc
-----------------------------------------------
1. Name: dbs [Cashback: 2.00%] [Cashback gained: $0.00] [Card limit: $1000.00] [Balance left: $1000.00]
-----------------------------------------------

Modify a credit card: `update`

Modifies a credit card on your credit card list at the specified index.
Use the list /cc command to view the current indexes of your credit cards.

Format: `update /cc [INDEX] /n [NEW_NAME] /cb [NEW_CASHBACK] /cl [NEW_CARD_LIMIT]`

[INDEX] refers to the index of credit card in list in which you want to update.
- Enter 1 if you want to update the first credit card in your list.
[NEW_NAME] refers to the name your Credit Card will be updated to.
- Use abbreviations for ease of adding expenditures to this credit card. For example: storing DBS Live Fresh Credit Card as DBS LF.
[NEW_CASHBACK] refers to the updated amount of cash back received when spending on the credit card.
- Enter the amount of cashback in percentage.
- For example: a credit card with 2% cashback can be represented as /cb 2.
[NEW_CARD_LIMIT] refers to the updated maximum monthly expenditure on this credit card.
- Enter the monthly maximum amount that can be spent on the credit card in dollars.

Expected Outcome:

For example: update /cc 1 /n OCBC /cb 1.5 /cl 500
Updates the first credit card on your list to have a name of ‘OCBC’ with a cashback of 1.5% and a monthly spending limit of $500.

> list /cc
-----------------------------------------------
1. Name: dbs [Cashback: 2.00%] [Cashback gained: $0.00] [Card limit: $1000.00] [Balance left: $1000.00]
-----------------------------------------------

> update /cc 1 /n OCBC /cb 1.5 /cl 500
Successfully set credit card 1 to:
Name: OCBC [Cashback: 1.50%] [Cashback gained: $0.00] [Card limit: $500.00] [Card balance: $500.00]

💡 Note:

This command is similar to the add a credit card command.

Parameters that are labeled starting with NEW follow the same restrictions in add a credit card.

For example: [NEW_NAME] can be abbreviated like [CREDIT_CARD_NAME].

Only enter [INDEX] that exist in your list. For example if you have 4 items in the credit card list, specify [INDEX] to be a number from 1 to 4.

You are not allowed to update the spending limit to an amount below what you have already spent using this card.

For Example: You have already spent $500 using the card. You will not be allowed to update the spending limit to a number less than $500.

⚠️Warning⚠️

Updating a credit card would cause its cashback earned to reset to 0. Similarly, its balance left will also be reset to the spending limit.

Remove a credit card: `delete`

Deletes a credit card from your list at the specified index.
Use the list /cc command to view the current indexes of your credit cards.

Format: `delete /cc [INDEX]`

[INDEX] refers to the index of credit card in your credit card list in which you want to delete.
- Enter 2 if you want to delete the second credit card in your credit card list.

Expected Outcome

For example: delete /cc 1
Deletes the first credit card on your credit card list.

> list /cc
-----------------------------------------------
1. Name: OCBC [Cashback: 1.50%] [Cashback gained: $0.00] [Card limit: $500.00] [Balance left: $500.00]
-----------------------------------------------

> delete /cc 1
I have removed OCBC from your list of credit card(s).

💡 Note:

Only enter [INDEX] that exist in your list. For example: if you have 4 credit cards in your list, specify [INDEX] to be a number from 1 to 4.

Do not use delete /cc when your credit card list is empty.

Calculate cashback: `calculate` [coming in v3.0]

Details coming soon…

Income

Income refers to the various sources of income you might have.

Display help page for incomes: `help`

Prints a list of commands related to income.

Format: `help /i`

Expected Outcome:

For example: help /i
Shows the help page for income related commands.

> help /i
--------------------------------Income Help Page---------------------------------------
1. Listing all Incomes: list /i
2. Adding an Income entry: add /i /a [AMOUNT] /c [CATEGORY]
3. Updating an Income entry: update /i [INDEX] /a [NEW_AMOUNT] /c [NEW_CATEGORY]
4. Removing an Income entry: delete /i [INDEX]
---------------------------------------------------------------------------------------

Add an income: `add`

Adds an income into your income list. Only one income can be added per command.

Format: `add /i /a [AMOUNT] /c [CATEGORY]`

[AMOUNT] refers to the monthly sum received, as a whole number.
[CATEGORY] refers to the supported categories of income.
- Enter Salary, Allowance, Investment or Others.

Expected Outcome:

For example: add /i /a 3000 /c salary
Adds an income of $3000 categorised as your Salary.

> add /i /a 3000 /c salary
Successfully added: 

Amount: $3000
Category: Salary

into the account

💡 Note:

[CATEGORY] is case-insensitive.

⚠️Warning⚠️

[CATEGORY]: Any input that is not Salary, Allowance, Investment or Others will be rejected.

[AMOUNT]: Takes in whole numbers as an input. Round off your income to the nearest whole number when entering it into MindMyMoney.

Display incomes: `list`

Prints your current list of income entries.

Format: `list /i`

Expected Outcome:

For example: list /i
Lists all your income entries.

> list /i
-----------------------------------------------
1. Amount: $3000
   Category: Salary
-----------------------------------------------

Modify an income: `update`

Modifies an income in your income list at the specified index.
Use the list /i command to view the current indexes of your income entries.

Format: `update /i [INDEX] /a [NEW_AMOUNT] /c [NEW_CATEGORY]`

[INDEX] refers to the index of income in list in which you want to update.
- Enter 1 if you want to update the first entry in the list.
[NEW_AMOUNT] refers to the updated monthly sum received, as a whole number.
[NEW_CATEGORY] refers to the supported categories of income.
- Enter Salary, Allowance, Investment or Others.

Expected Outcome:

For example: update /i 1 /a 4000 /c salary
Updates the first income entry on your income list to $4000 categorised as your salary.

> list /i
-----------------------------------------------
1. Amount: $3000
   Category: Salary
-----------------------------------------------

> update /i 1 /a 4000 /c salary
Successfully set income 1 to:
Amount: $4000
Category: Salary

💡 Note:

This command is similar to the add an income command.

Fields that are labeled starting with NEW follow the same restrictions in add an income.

For example: [NEW_AMOUNT] input has to be a whole number, similar to [AMOUNT].

[CATEGORY] is case-insensitive.

Only enter [INDEX] that exist in your list. For example: if you have 4 incomes in your income list, specify [INDEX] to be a number from 1 to 4.

⚠️Warning⚠️

[NEW_CATEGORY]: Any input not in the accepted list of categories will be rejected.

Remove an income: `delete`

Deletes an income from your income list at the specified index.
Use the list /i command to view the current indexes of your income entries.

Format: `delete /i [INDEX]`

[INDEX] refers to the index of income in your income list you want to delete.
- Enter 1 if you want to delete the first income in your income list.

Expected Outcome:

For example: delete /i 1
Deletes the first income entry on your income list.

> list /i
-----------------------------------------------
1. Amount: $4000
   Category: Salary
-----------------------------------------------

> delete /i 1
I have removed Salary from your list of income(s).

💡 Note:

Only enter [INDEX] that exist in your list. For example: if you have 4 incomes in your income list, specify [INDEX] to be a number from 1 to 4.

Do not use delete /i when your income list is empty.

Exit MindMyMoney application: `bye`

Shuts down the MindMyMoney application.

Format: `bye`

Expected Outcome:

For example: bye
Exits the program.

> bye
Bye, hope to see you again!

💡 Note

Any input after the bye command is ignored. For example: bye Hello World will still exit the program.

Save the Data

Your MindMyMoney data is saved in the hard disk automatically after any command that changes the data. There is no need for you to save manually. You can view the saved contents of MindMyMoney by reading the data.txt file in your current directory.

💡 Note:

If you wish to back up your MindMyMoney data, you can copy the data.txt file into the folder you want to save it in.

To load the backup data into MindMyMoney, copy data.txt from the backup folder into the folder containing MindMyMoney, replacing the existing copy of data.txt.

Editing the Save File

If you are experienced in using MindMyMoney, you may wish to directly edit the data.txt file. Below is a short description of its format.

⚠️Warning⚠️

Be careful when modifying data.txt to follow the correct format, since doing so can corrupt the data in MindMyMoney. When in doubt, keep a backup, as stated above. If you are less experienced, you may use the update and add commands to edit the data.

data.txt must contain the following six lines, in this order:

# BEGIN EXPENDITURES
# END EXPENDITURES
# BEGIN CREDIT CARDS
# END CREDIT CARDS
# BEGIN INCOME SOURCES
# END INCOME SOURCES

Each expenditure, credit card, and income is stored in one line between their respective BEGIN/END lines. No line should be left blank.

Each piece of data is stored as a series of key : value pairs, separated by spaces. Both key and value are enclosed in quotes. A \" in a key or value represents a quotation mark, while a \\ represents a backslash.

The following are the keys required for each type of data:

Expenditures contain amount, description, paymentMethod, time, and category keys.
Credit cards contain totalExpenditure, monthlyCardLimit, nameOfCard, and cashback keys.
Incomes contain amount and category fields.

Their meanings are the same as in the add commands. The totalExpenditure key of a credit card contains the total amount spent using that credit card.

If a key is missing, MindMyMoney will consider the save file invalid.

Here is an example of a valid save file:

# BEGIN EXPENDITURES
 "amount": "3.0"  "description": "Commute"  "paymentMethod": "Cash"  "time": "08/03/2022"  "category": "Transport" 
 "amount": "1.0"  "description": "Mala"  "paymentMethod": "DBS"  "time": "30/03/2022"  "category": "Food" 
 "amount": "1.0"  "description": "Chicken rice"  "paymentMethod": "DBS"  "time": "30/03/2022"  "category": "Food"
 "amount": "1.0"  "description": "Katsudon"  "paymentMethod": "Cash"  "time": "07/03/2022"  "category": "Food"
# END EXPENDITURES
# BEGIN CREDIT CARDS
 "totalExpenditure": "2.0"  "monthlyCardLimit": "10000.0"  "nameOfCard": "DBS"  "cashback": "1.0"
 "totalExpenditure": "0.0"  "monthlyCardLimit": "20000.0"  "nameOfCard": "OCBC"  "cashback": "4.0"
# END CREDIT CARDS
# BEGIN INCOME SOURCES
 "amount": "200"  "category": "Allowance"
 "amount": "500"  "category": "Investment" 
# END INCOME SOURCES

FAQ

Q: Why is my data not saved when I run MindMyMoney in different folders?

A: MindMyMoney saves data in the current directory. To ensure all the data is saved properly, run MindMyMoney only in the home folder. If you wish to run MindMyMoney in different folders and still contain your data, copy the data.txt file found in the current directory into a new folder where you want to run MindMyMoney in.

Command Summary (Expenditure)

Command	Format, examples
Help	`help /e` Prints a list of commands related to expenditures.
Add	`add /e /pm [PAYMENT_METHOD] /c [CATEGORY] /d [DESCRIPTION] /a [AMOUNT] /t [DATE]` For example: `add /e /pm cash /c Food /d Porridge /a 4.50 /t 10/03/2022` Adds a $4.50 expenditure of Food item ‘Porridge’ that was paid in cash on 10 March 2022 to your expenditure list.
List	`list /e {DATE}` For example: `list /e 03/03/2022` Displays your current list of expenditures on 3 March 2022.
Calculate	`calculate /epm [DATE]` For example: `calculate /epm 03/2022` Prints a breakdown of your expenditures for Mar 2022.
Delete	`delete /e [INDEX]` For example: `delete 1` Deletes the first expenditure from your expenditure list.
Update	`update /e [INDEX] /pm [NEW_PAYMENT_METHOD] /c [NEW_CATEGORY] /d [NEW_DESCRIPTION] /a [NEW_AMOUNT] /t [NEW_DATE]` For example: `update /e 1 /pm cash /c Food /d chicken rice /a 5 /t 12/03/2022` Updates the first expenditure in your expenditure list to a $5.00 expenditure of Food item ‘chicken rice’ that was paid in cash on 12 March 2022.
Exit	`bye` Ends the `MindMyMoney` application.

Command Summary (Credit Card)

Command	Format, examples
Help	`help /cc` Prints a list of commands related to credit cards.
Add	`add /cc /n [CREDIT_CARD_NAME] /cb [CASHBACK] /cl [CARD_LIMIT]` For example: `add /cc /n dbs /cb 2 /cl 1000` Adds a credit card of the name ‘DBS’ with a cashback of 2% and a monthly spending limit of $1000.
List	`list /cc` Displays your current list of credit cards.
Delete	`delete /cc [INDEX]` For example: `delete /cc 1` Deletes the first credit card from your credit card list.
Update	`update /cc [INDEX] /n [NEW_CARD_NAME] /cb [NEW_CASHBACK] /cl [NEW_CREDIT_LIMIT]` For example: `update /cc 1 /n OCBC /cb 1.5 /cl 500` Updates the first credit card on your credit card list to have a name of ‘OCBC’ with a cashback of 1.5% and a monthly spending limit of $500.
Exit	`bye` Ends the `MindMyMoney` application.

Command Summary (Income)

Command	Format, examples
Help	`help /i` Prints a list of commands related to income.
Add	`add /i /a [AMOUNT] /c [CATEGORY]` For example: `add /i /a 3000 /c salary` Adds an income of $3000 categorised as your Salary.
List	`list /i` Displays your current list of income entries.
Delete	`delete /i [INDEX]` For example: `delete /i 1` Deletes the first income from your income list.
Update	`update /i [INDEX] /a [NEW_AMOUNT] /c [NEW_SALARY]` For example: `update /i 1 /a 4000 /c salary` Updates the first income entry on your income list to $4000 categorised as your Salary.
Exit	`bye` Ends the `MindMyMoney` application.

MindMyMoney User Guide

Content Page

Introduction

MindMyMoney

Using the User Guide

Quick Start

Features

Introduction to Commands

Expenditure

Display help page for expenditures: help

Format: help /e

Expected Outcome:

Add an expenditure: add

Format: add /e /pm [PAYMENT_METHOD] /c [CATEGORY] /d [DESCRIPTION] /a [AMOUNT] /t [DATE]

Expected Outcome:

Display expenditures: list

Format: list /e {DATE}

Expected Outcome:

Modify an expenditure: update

Format: update /e [INDEX] /pm [NEW_PAYMENT_METHOD] /c [NEW_CATEGORY] /d [NEW_DESCRIPTION] /a [NEW_AMOUNT] /t [NEW_DATE]

Expected Outcome:

Remove an expenditure: delete

Format: delete /e [INDEX]

Expected Outcome:

Calculate expenditures: calculate

Format: calculate /epm [DATE]

Expected Outcome:

Credit Card

Display help page for credit cards: help

Format: help /cc

Expected Outcome:

Add a credit card: add

Format: add /cc /n [CREDIT_CARD_NAME] /cb [CASHBACK] /cl [CARD_LIMIT]

Expected Outcome:

Display credit cards: list

Format: list /cc

Expected Outcome:

Modify a credit card: update

Format: update /cc [INDEX] /n [NEW_NAME] /cb [NEW_CASHBACK] /cl [NEW_CARD_LIMIT]

Expected Outcome:

Remove a credit card: delete

Format: delete /cc [INDEX]

Expected Outcome

Calculate cashback: calculate [coming in v3.0]

Income

Display help page for incomes: help

Format: help /i

Expected Outcome:

Add an income: add

Format: add /i /a [AMOUNT] /c [CATEGORY]

Expected Outcome:

Display incomes: list

Format: list /i

Expected Outcome:

Modify an income: update

Format: update /i [INDEX] /a [NEW_AMOUNT] /c [NEW_CATEGORY]

Expected Outcome:

Remove an income: delete

Format: delete /i [INDEX]

Expected Outcome:

Exit MindMyMoney application: bye

Format: bye

Expected Outcome:

Save the Data

Editing the Save File

FAQ

Command Summary (Expenditure)

Command Summary (Credit Card)

Command Summary (Income)

Display help page for expenditures: `help`

Format: `help /e`

Add an expenditure: `add`

Format: `add /e /pm [PAYMENT_METHOD] /c [CATEGORY] /d [DESCRIPTION] /a [AMOUNT] /t [DATE]`

Display expenditures: `list`

Format: `list /e {DATE}`

Modify an expenditure: `update`

Format: `update /e [INDEX] /pm [NEW_PAYMENT_METHOD] /c [NEW_CATEGORY] /d [NEW_DESCRIPTION] /a [NEW_AMOUNT] /t [NEW_DATE]`

Remove an expenditure: `delete`

Format: `delete /e [INDEX]`

Calculate expenditures: `calculate`

Format: `calculate /epm [DATE]`

Display help page for credit cards: `help`

Format: `help /cc`

Add a credit card: `add`

Format: `add /cc /n [CREDIT_CARD_NAME] /cb [CASHBACK] /cl [CARD_LIMIT]`

Display credit cards: `list`

Format: `list /cc`

Modify a credit card: `update`

Format: `update /cc [INDEX] /n [NEW_NAME] /cb [NEW_CASHBACK] /cl [NEW_CARD_LIMIT]`

Remove a credit card: `delete`

Format: `delete /cc [INDEX]`

Calculate cashback: `calculate` [coming in v3.0]

Display help page for incomes: `help`

Format: `help /i`

Add an income: `add`

Format: `add /i /a [AMOUNT] /c [CATEGORY]`

Display incomes: `list`

Format: `list /i`

Modify an income: `update`

Format: `update /i [INDEX] /a [NEW_AMOUNT] /c [NEW_CATEGORY]`

Remove an income: `delete`

Format: `delete /i [INDEX]`

Exit MindMyMoney application: `bye`

Format: `bye`