JBOPS/killstream/limiterr_readme.md
2019-04-25 16:11:57 -04:00

63 lines
1.9 KiB
Markdown

# README
Killing streams is a Plex Pass only feature. So these scripts will **only** work for Plex Pass users.
## `limitter.py` examples:
### Limit user to an amount of Plays of a show during a time of day
_For users falling asleep while autoplaying a show_ :sleeping:\
Triggers: Playback Start
Conditions: \[ `Current Hour` | `is` | `22 or 23 or 0 or 1` \]
Arguments:
```
--jbop limit --username {username} --sessionId {session_id} --grandparent_rating_key {grandparent_rating_key} --limit plays=3 --delay 60 --killMessage "You sleeping?"
```
### Limit user to total Plays/Watches and send a notification to agent 1
_Completed play sessions_ \
Triggers: Playback Start
Arguments:
```
--jbop watch --username {username} --sessionId {session_id} --limit plays=3 --notify 1 --killMessage "You have met your limit of 3 watches."
```
### Limit user to total Plays/Watches in a specific library (Movies)
_Completed play sessions_ \
Triggers: Playback Start
Arguments:
```
--jbop watch --username {username} --sessionId {session_id} --limit plays=3 --section Movies --killMessage "You have met your limit of 3 watches."
```
### Limit user to total time watching
Triggers: Playback Start
Arguments:
```
--jbop time --username {username} --sessionId {session_id} --limit days=3 --limit hours=10 --killMessage "You have met your limit of 3 days and 10 hours."
```
### Limit user to total play sessions for the day
Triggers: Playback Start
Arguments:
```
--jbop plays --username {username} --sessionId {session_id} --today --limit plays=3 --killMessage "You have met your limit of 3 play sessions."
```
### Limit user to total time watching for the day, including duration of item starting
Triggers: Playback Start
Arguments:
```
--jbop time --username {username} --sessionId {session_id} --duration {duration} --limit hours=2 --killMessage "You have met your limit of 3 days and 10 hours."
```