Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lemaik/moneylover-cli
A CLI client for Money Lover.
https://github.com/lemaik/moneylover-cli
cli moneylover nodejs
Last synced: 2 days ago
JSON representation
A CLI client for Money Lover.
- Host: GitHub
- URL: https://github.com/lemaik/moneylover-cli
- Owner: leMaik
- License: mit
- Created: 2018-05-21T12:29:01.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-12-22T08:33:05.000Z (about 2 years ago)
- Last Synced: 2024-12-01T14:21:33.883Z (25 days ago)
- Topics: cli, moneylover, nodejs
- Language: JavaScript
- Size: 125 KB
- Stars: 27
- Watchers: 5
- Forks: 8
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Money Lover CLI
This is a CLI tool for [Money Lover][moneylover], the "simplest way to manage personal finances" (according to their website). It has apps for iOS and Android and also a Webapp.
Money Lover CLI uses the API underneath that webapp to let you track your expenses from the command line. Because time is money, and you can save time by using some nice CLI commands.
## Installation
```
npm i -g moneylover-cli
```
## Usage
### Authentication
#### Using a MoneyLover account
If you are using a Money Lover account for login, you can log in with the following command.
```
moneylover login
```
#### Using Facebook or Google (with Google Chrome installed)
If you are using Google or Facebook and have Google Chrome installed, a browser window will open and you can authenticate as usual. The window will automatically close after successful authentication. Just run `moneylover login` without any arguments.
#### Using Facebook or Google (without Google Chrome installed)
You'll have to manually log into the webapp for now and extract your JWT token from the `Authorization` header of API requests (without the `Bearer` prefix), e.g. `eyJ0e…`. You can then log in with the following command.
```
moneylover login --jwt eyJ0e…
```
### Logout
The token is only valid for a week, and will be cached in your home directory as `.moneylovercli`. To remove that file, run
```
moneylover logout
```
### Manage your money
Once you're authenticated, it's time to actually use the tool to manage your money.
To add a transaction, use the `expense` or `income` sub-command, e.g.
```
moneylover expense Bank -m "Fuel" -d "last friday" -c "Fuel"
```
The date is parsed using [Chrono][chrono], so you can use human-readable dates. You can also specify a category using `--category`, which can be any of the categories listed in `moneylover categories `. It defaults to _Other_.
### Wait, there is more!
Just run `moneylover help` to get a list of all the things you can do. Every sub-command also has a `--help` flag that will show the available options.
[moneylover]: https://moneylover.me/
[chrono]: https://github.com/wanasit/chrono