JBOPS/killstream/limiterr_readme.md
Landon Abney 2be0e376f8
Massive style cleanup
Adds a basic `setup.cfg` file with configurations for flake8 and pylama, 
fixes some basic issues with essentially every file including:
* Many, many, whitespace line cleanups
* Several unused variables and imports
* Missing coding and shabang lines
* Minor style fixes to more closely align with PEP8
* Turn `print` into function calls for Python 2/3 compat
* A few minor bugs
  * Things like using an undefined `i` in `stream_limiter_ban_email.py`
2019-06-20 23:55:11 -07:00

1.9 KiB

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 😴
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."