Skip to content

Commit

Permalink
update docs (#25)
Browse files Browse the repository at this point in the history
  • Loading branch information
pinkywafer authored Jan 20, 2021
1 parent ccc19f3 commit 37b53ad
Show file tree
Hide file tree
Showing 3 changed files with 29 additions and 1 deletion.
16 changes: 15 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,17 @@ _A platform which give you info about the newest video on a channel._

![example][exampleimg]

## __BREAKING CHANGE__

Video views and stars are now reported. As a result any automations triggered by state will now be triggered when the number of views or stars changes. To avoid this, add the url attribute to the trigger so that the automation is only triggered when the reported url changes ie:

``` yaml
trigger:
- platform: state
entity_id: sensor.franck_nijhof
attribute: url
```
## Installation
To get started put all the files from`/custom_components/youtube/` here:
Expand Down Expand Up @@ -38,9 +49,12 @@ key | type | description

* url: URL of the most recent video
* published: The time and date the video was published
* stars: The 'stars' recieved on youtube. (This is all reactions both 👍 and 👎 combined)
* views: the number of video views
* stream: If the video was streamed live
* live: If the video is live now
* channel_is_live: If any video on the channel is currently live
* channel_is_live: If any video on the channel is live
* channel_image: URL of the channel logo image

***

Expand Down
Binary file modified example.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
14 changes: 14 additions & 0 deletions info.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,17 @@ _A platform which give you info about the newest video on a channel._

![example](https://github.com/custom-components/sensor.youtube/raw/master/example.png)

## __BREAKING CHANGE__

Video views and stars are now reported. As a result any automations triggered by state will now be triggered when the number of views or stars changes. To avoid this, add the url attribute to the trigger so that the automation is only triggered when the reported url changes ie:

``` yaml
trigger:
- platform: state
entity_id: sensor.franck_nijhof
attribute: url
```
## Example configuration.yaml
```yaml
Expand All @@ -29,6 +40,9 @@ key | type | description
* url: URL of the most recent video
* published: The time and date the video was published
* stars: The 'stars' recieved on youtube. (This is all reactions both 👍 and 👎 combined)
* views: the number of video views
* stream: If the video was streamed live
* live: If the video is live now
* channel_is_live: If any video on the channel is live
* channel_image: URL of the channel logo image

0 comments on commit 37b53ad

Please sign in to comment.