READ FIRST: Guidelines for Posting Channel Plugin Issues/Questions and Things to Check First


The Channel Plugin section of the forum is for questions or issues with plugins you have installed on Plex Media Server using the Plugins Directory, UAS2, or manually from other sources like Github. Please review the following guidelines, tips, and links before posting, since it can save you time and ensure that you will receive the help and support you need most efficiently.

Plex users who are new to Plex plugins should review the Channel Plugins Support Articles since the most common issues and questions are answered there. When posting a new topic, the support article How Do I Post on the Forum to Make Sure I Get the Best Help provides details that should be included in your post.

Make Sure You Are Using the Latest Version of Plex Media Server

Earlier version of Plex Media Server may have had issues that were fixed in later releases, so before posting an issue make sure you are using the latest public version of Plex Media Server to ensure you have all the most recent bugfixes.

Reboot Plex Media Server and Verify Internet Connection

Plex plugins access online content, so you must have an Internet connection available for your Plex Media Server and every Plex Player/device you are using when using Plex plugins. Before posting any issues in the Channel Plugin Forum, try rebooting your Plex Media Server and ensure that have an Internet connection to all Plex devices.

Check Website Availability/Region-Restrictions

Before posting an issue with a Plex plugin, try to access the website for that plugin from a browser to make sure the website is working properly and provides the media you are trying to access and play. Plex plugins just provide a "Plex-friendly" interface to access existing online media and each Plex plugin accesses and plays the media provided by the website for which it is named. Therefore you will only be able to access and play media from a Plex plugin if the website for that plugin is working and allows you to play the media from your web browser.

Plugins will only list and allow users to play media that is free and does not require a cable subscription. So make sure that the media is available on the website and does not require you to log into a TV provider when using a browser. The website will often display a lock or key icon in the thumbnail image of media that requires a TV provider login.

If the media in a plugin will not play, make sure the videos will play directly from the website when using your browser. Some websites, especially for Network TV, may choose to region-restrict their media and only allow you to play that media if your IP addresses is within a specific region or country. If your region is set properly, plugins offered in the Plugins Directory that are region-restricted and will not play in your region should only be listed in the "Foreign (Region-Restricted)" section of the Plugins Directory. See Region Settings to properly set your region in Plex.

Issues with Plugins from Sources Other than the Plugins Directory (aka Unsupported Plugins)

Unsupported Plugins are often less stable, require special instructions and may even no longer be maintained or supported by its developer. Since these plugin's stability, support, and specifications vary so much, as the name implies, unsupported plugins do not and cannot be supported by the larger volunteer plugin community. So any issues or questions must be addressed by the individual developer of that unsupported plugin and/or its users. Therefore, you must use the support options offered by each unsupported plugin's developer to resolve any issues with each individual unsupported plugin.

See How do I get support for unsupported channels? and the pinned topic SUPPORT: Find my Plug-In here for support for a list of known support topics for unsupported plugins. If the plugin developer has not created a support thread, you would need to refer to the source where you found and installed the plugin bundle (like a website or Github repository) to find any support options offered by its developer.

Even issues with multiple unsupported plugins must be handled individually. So you should always install and test at least a couple Plugins from the Plugin Directory. Since those are the plugins that are known to be stable and work on a regular basis, installing and testing at least a couple plugins from the Plugins Directory can help you determine if there is an overall issue with Plex Media Server accessing and playing plugins.

Issues with the iTunes or Aperture Channels

The iTunes and Aperture channels are not actually Plex plugins. They are extensions of Plex Media Server. That is why you enable them in the Plex Media Server setting instead of adding them using the Plugins Directory. So any issues with the iTunes and Aperture channels must be posted to the section of the forum for Plex Media Server on your operating system or the section for the Plex player app that is having issues accessing these channels.

Plex Player App/Plex Media Server Issues

Lastly, understand that Plex plugins just access online content and put its data in a Plex-friendly format that each Plex player app can read. Each Plex player app must be programmed to properly read the data provided by plugins and decide how to best play its media based on the software of that player. Also, since no Plex player supports every format that may be available on the Internet, you must have a Plex Media Server that is configured properly and has the CPU power necessary to transcode media or plugin media that is not compatible with your Plex player will not play.

The community of volunteer developers who monitor this forum only design and maintain the individual Plex plugins. While these volunteers are always happy to try and help, they are not Plex employees and are not involved in the development of PMS or the various Plex player apps that provide access to the content on PMS, including the Plugins Directory and Plex plugins.

So, if the Plex plugins are working as expected, but you are having issues with a specific Plex player app displaying or playing plugin content or with Plex Media Server transcoding plugin media, then that is an issue that would need to be addressed by the developers of that Plex Player app or version of Plex Media Server and would need to be posted to that section of the forum.