https://github.com/elpachongco/expenses-cli

My personal expenses tracker
https://github.com/elpachongco/expenses-cli

budget-app finance papaparse plaintextaccounting vuejs

Last synced: 10 days ago
JSON representation

My personal expenses tracker

• Host: GitHub
• URL: https://github.com/elpachongco/expenses-cli
• Owner: elpachongco
• Created: 2024-09-02T13:40:20.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2024-09-14T16:02:18.000Z (21 days ago)
• Last Synced: 2024-09-21T10:05:13.700Z (14 days ago)
• Topics: budget-app, finance, papaparse, plaintextaccounting, vuejs
• Language: JavaScript
• Homepage: http://earlps.net/expenses-cli/
• Size: 13.1 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Expenses calculator

My personal expenses calculator

## How I use this calculator

1. Keep a file `expenses.csv` in my phone

2. Each transaction recorded in the csv file. 

- Some are aggregated, e.g. If I go to the grocery, I just record 'grocery' (not item per item)

> [!TIP]

> Markor is a nice FOSS Android text editor that supports .csv files

3. From time to time, upload the file to the webpage.

## Structure of expenses.csv

DATE, ITEM NAME, AMOUNT, PRICE, CATEGORY

- DATE - ISO8601 String or variants OR "UPCOMING"

- ITEM NAME - String name

- AMOUNT - Number followed by unit e.g. 8.5kg, 1.2L

- PRICE - Financial number

- CATEGORY - Category of item e.g. "BILLS". Can be grouped by "/" e.g. BILLS/UTILITY, BILLS/RENT,

> [!NOTE]  

> Date doesn't have to be filled in everytime. If a date is added to a row, all other rows that don't have date will use the date from the last row that have a date.

Comments can be added by starting the row with "#" character.

The line 

```

# TEST, TEST TEST

```

will be excempted from processing.

## Example file

```csv

DATE, ITEM NAME, AMOUNT, PRICE, CATEGORY

2024-09-03 12:01, TAXI, 1, 150, TRANSPORTATION

, MEAL, 1, 200, FOOD

, TAXI, 1, 150, TRANSPORTATION

2024-09-04 10:55, GROCERY, 2500, FOOD

```

## More information

I made a [Blog post](https://earlps.net/post/2024-09-14-tracking-expenses/) about this project.