Skip to content

Commit

Permalink
Update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Leonid authored and Leonid committed Jul 31, 2019
1 parent 48a96eb commit 0dcbbfc
Showing 1 changed file with 24 additions and 6 deletions.
30 changes: 24 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,26 @@
# ynab
YNAB component for Home Assistant
YNAB component for Home Assistant
This component will retreieve the following data from your YNAB budget
1. To be budgeted amount
2. Current month's budgeted amount
3. Current month's remaining balance of any specified category

## Installation
#### HACS
1. Open HACS > Settings
2. In ADD CUSTOM REPOSITORY box paste this git's URL https://github.com/wxt9861/ynab and select type Integration
3. Click INSTALL
4. Make necessary modifications to your configuration.yaml
5. Restart Home Assistant

#### Manual install
1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
2. If you do not have a custom_components directory (folder) there, you need to create it.
3. In the custom_components directory (folder) create a new folder called breaking_changes.
4. Download all the files from the custom_components/ynab/ directory (folder) in this repository.
5. Place the files you downloaded in the new directory (folder) you created.
6. Add ynab: to your HA configuration (see examples below)
7. Restart Home Assistant

## Configuration options

Expand All @@ -13,13 +32,13 @@ Key | Type | Required | Default | Description
`currency` | `string` | False | $ |Currency to use as unit of measurement
`categories` | `list` | False | None |List of YNAB categories to include in the sensor. These are <b>CASE SENSATIVE<b>

## Example default configuration.yaml
### Example default configuration.yaml
```yaml
ynab:
api_key: <api_key_here>
```
## Example: configuration.yaml with options
### Example: configuration.yaml with options
```yaml
ynab:
api_key: <api_key_here>
Expand All @@ -30,15 +49,14 @@ ynab:
- "HASS Budget"
- "Vacation Budget"
```
## Generate YNAB API key / Get budget ID
### Generate YNAB API key / Get budget ID
API:
1. Log on to YNAB
2. Go to My Budget > My Account > Developer Settings
3. Click on New Token
4. Enter your password and click Generate
5. Copy the token that appears at the top of the page
Bidget ID:
Bidget ID:
The budget ID is the combination between the slahses after the URL https://app.youneedabudget.com
If you only have one budget, you can leave the budget option at default, if you have multiple budgets pick a budget you want the sensor to report on. At this time data from only 1 budget is retrieved.

0 comments on commit 0dcbbfc

Please sign in to comment.