https://github.com/ob6160/caffeine
Attempts to find out how much you've spent on coffee so far this month.
https://github.com/ob6160/caffeine
coffee hacktoberfest monzo open-banking starling
Last synced: 5 months ago
JSON representation
Attempts to find out how much you've spent on coffee so far this month.
- Host: GitHub
- URL: https://github.com/ob6160/caffeine
- Owner: ob6160
- License: gpl-3.0
- Created: 2020-01-17T10:12:55.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2021-10-03T19:27:47.000Z (about 4 years ago)
- Last Synced: 2025-03-30T02:41:36.499Z (6 months ago)
- Topics: coffee, hacktoberfest, monzo, open-banking, starling
- Language: Shell
- Homepage:
- Size: 53.7 KB
- Stars: 9
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# caffeine
Find out how much you've spent on coffee so far this month.
Monzo and Starling are supported currently.
## Monzo setup
You'll need a Monzo access token and your account id. Find them here: https://developers.monzo.com/api/playground
## Starling setup
You'll need a Starling access token, your account info is automatically fetched using it.
Generate one by signing up here: https://developer.starlingbank.com/personal/list
(I think) you'll need the following scopes: `account:read, account-identifier:read, payee-transaction:read, transaction:read`
## Deps
* jq - https://stedolan.github.io/jq/
* bc - (B)asic (C)alculator
* curl
* sed
## Usage
### Monzo
`$ MONZO_TOKEN=xxx MONZO_ACCOUNT_ID=xxx ./caffeine.sh`
### Starling
`$ STARLING_TOKEN=xxx ./caffeine.sh`
### Month offset
You are able to view past months by setting the `OFFSET_MONTHS` flag to the number of months you want to check in the past.
As an example, if you're in October and you want to check your spend in August, pass **2** to this flag.
`$ STARLING_TOKEN=xxx OFFSET_MONTHS=2 ./caffeine.sh`