A plugin for Plex Media Server to allow streaming of Twitch.tv live streams. It also allows viewing of Past Broadcasts and Highlights of Twitch.tv channels.
Clone or download
Pull request Compare This branch is 99 commits ahead, 2 commits behind plexinc-plugins:master.
Latest commit 6aecc72 Jan 30, 2017
Failed to load latest commit information.
Contents quick fix for vods Jan 31, 2017
.gitignore cleanup Jul 17, 2015
README.md Update README.md Oct 13, 2016


Donate btc: 1JJD5i4jL5qmbMKCy1sNVGgQzx1Jh37rFH


Put TwitchMod.bundle into Plex Media Server/Plug-ins


General Preferences

  • Username: The username to get followed channels for. This channel does not need your password since Twitch lets you pull this data without authenticating.
  • Order Following By: The ordering of the followed channels page. Ordering by views will put all online channels first.
  • Favourite Games: A comma separated list of games titles. Use this if you like viewing games with small amounts of viewers. Game titles dont have to be exact matches. ex: diablo, starcraft.
  • Title Layout: What info is shown in the stream title. If you don't like any of the options, please suggest some.
  • Title Layout (game lists): A separate title layout for lists where you know the game title going in.
  • Hide Offline Channels: Hide offline channels in the 'followed channels' menu.
  • Access Token (optional): OAuth token to allow watching subscriber-only VODs.

Quality Prefrences

If you have issues getting streams to load on a particular Plex client, try the various options here.

  • Stream Quality, VOD Quality
    • Automatic - The client gets the master playlist. If the client supports adaptive streaming, it can make its own decisions.
    • Manual - For clients that allow users to select video quality (PHT).
    • Source/High/Medium/Low/Mobile - Explicitly use the selected quality. If the chosen quality does not exist on the chose stream, it will get the closest match.

If none of these options work, then it is likely that your client does not currently support HLS streams.

Getting an Access Token

  1. At the bottom of the main menu in the channel, there will be an Authorize option.
  2. It will give you a url to go to in a web browser. (using a url shortener http://shoutkey.com url is valid for 5 min)
  3. that redirects you to a Twitch page to authorize the channel to use your account.
  4. When you authorize it redirects your browser to http://localhost/#access_token=<access_token>&scope=user_read which is a dead page.
  5. copy the <access_token> string out of that url and put it in the TwitchMod channel preferences using the web interface.