https://github.com/foxt/moneywidget
iOS Widget for displaying Monzo balance
https://github.com/foxt/moneywidget
Last synced: about 2 months ago
JSON representation
iOS Widget for displaying Monzo balance
- Host: GitHub
- URL: https://github.com/foxt/moneywidget
- Owner: foxt
- License: mit
- Created: 2025-01-27T17:51:10.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2025-01-27T17:51:11.000Z (4 months ago)
- Last Synced: 2025-03-28T13:04:46.808Z (about 2 months ago)
- Language: TypeScript
- Size: 27.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# moneywidget
iOS Widget for displaying Monzo balance
## Screenshots
TODO
## Installation
This application currently makes the assumption that you get paid monthly on the last working day of the month. If you don't, well, that's what pull requests are for 🙃
### Backend
Because I absolutely hate Swift with a passion, the app uses a split backend written in Node.js to actually gather the data from Monzo.
1. Create a client ID & secret at https://developers.monzo.com/
2. Create a `.env` file in the `backend` folder with the following content, changing the variables accordingly.
1. For `BANK_HOLIDAY_REGION` enter `england-and-wales`, `scotland`, or `northern-ireland` depending on where you are in the UK.
2. `EXCLUDE_CATEGORIES` will not be count as spending (use for things like bills, salary etc). Custom categories you'll have to find the ID in the transactions data.
```
PORT=6077
API_KEY=(a randomly generated string to prevent unauthorized access)
MNZ_CLIENT_ID=(your monzo client ID)
MNZ_CLIENT_SECRET=(your monzo client secret)
DATA_FILE=(a location to store data like access tokens and cached transactions, i.e. /home/me/.monzowidget.json)
BANK_HOLIDAY_REGION=england-and-wales
EXCLUDE_CATEGORIES=savings,bills,family,income
```
3.
### iOS App
1. Launch the project in Xcode and install the app on your device. You may need to update the team ID used for codesigning.
2. Add the widget to your homescreen. You will need to set the URL in the config to `https://server/status?api_key=API_KEY`
3.