Beta Testing
Channel is currently migrating out of beta, so the following is no longer needed, but is left for legacy purposes.
The UnSupportedServicesTools.bundle (USST) is a plugin dedicated to installing and updating the UnSupportedServices.bundle (USS). The USS is a system Services channel that contains service code for multiple host sites, just like the official Services.bundle.
At the time I started creating this plugin, the official Services.bundle was only updated with every Plex Media Server (PMS) release. As of PMS v0.9.17.2 the Services.bundle is now dynamically updated independent of PMS releases. Thus potentially making my UnSupportedServices.bundle unnecessary. For now, I'm going to continue pursuing the implementation of the UnSupportedServices.bundle, but may someday work at getting its code integrated into the official Services.bundle and phase out this plugins necessity.
Note: Much of the USST code comes from the System.bundle
If you are here to help test the USST then continue bellow.
Pushing ahead with testing? Great!
Currently I've tested this with my own system: Ubuntu 14.04 LTS 64bit and PMS v0.9.16.6 & v1.0.0.2261. I tried PMS v0.9.17.x but ran into a trascoding issue. v1.0.0.2261 seems to have resolved the issue.
Please download and install the USST (no PMS restart needed, unless the channel does not show up).
- Follow the install directions from here
- Alternatively you can directly clone the
masterbranch withgit
I have restricted the USST to only allow USS management from the Plex Web client, so you will need to do all your testing through the Plex Web client. Other clients will show the plugin, but will only list info and allow test URL input. Clients other than Plex Web run every piece of code twice. This can cause issues while installing and bog down PMS.
The USST is setup to track changes in either the master branch or the dev branch. This can be changed from withing the channel's preferences. Currently the USST only allows for updates, so once an update has been applied, the user cannot downgrade (plan to allow downgrades in the future).
There is a search function included with the USST that allows the input of a test video URL. We will use this later to test the validity of the USS install.
The first time the USST runs it should show an option to install the new USS.
Make sure within the channel's preferences the Repo Branch is set to master.
Next select the Install New USS, and wait for it to install. A popup message should appear and tell you the status of the install (i.e. if it was successful, or failed).
If the install was successful, then continue, otherwise STOP testing and report the issue in the beta-testing: Initial Install Test - Issues thread. Do not continue if an error occurs.
Once installed the screen should look like the following.
- 1st button is a placeholder to display the current version and branch installed (versions are the latest commit timestamp)
- 2nd button Re-Install "x" branch: use to reinstall the current branch from it's latest commit
- 3nd button Check For Update: will check the current version vs the latest release version on GitHub. It does not preform the update, only checks for one.
- 4th button Supported Host: when selected, will list the current host supported by the installed USS
If USS installed correctly, then please report your success with PMS OS and Version to the beta-testing: Initial Install Test - Pass thread.
If USS reported installing correctly, then try testing the USS service code.
Open the USST channel and input the following into the search field http://vidto.me/ku5glz52nqe1.html
Hit the enter key, or select the Search in UnSupported Services Tools... button. If successful then the following screen should appear.
Either play the video from this screen or select the video and play from the next screen.
If the video does not play, or it never showed up to begin with, then STOP testing and skip to Error Reporting for URL Services Test
If your USS passed the ULR Services Test, then please report your success with PMS OS and Version to the beta-testing: URL Services Test - Pass thread.
- If error occurs then report issue in the beta-testing: ULR Services Test - Issues thread, with PMS OS and Version and USS repo branch.
If your installation of USST and USS passed the tests above, then you are ready to test the USST updater. To do so, first change the Repo Branch to dev from within the channel's preferences and press SAVE.
Next select the Check for Update button. A popup notification should display a message that a new update was found, and its timestamp. Go back to the channel's main menu and now it should look like the following.
Note, a new menu item appeared allowing for the installation of the update. The update button's summary will be the last commit message.
If the USST failed to find an update, then skip to Error Reporting for Updater Test
Select date Available - Install Update to install update (date being the latest commit date, i.e. bundle version)
If error then skip to Error Reporting for Updater Test
Once installation finishes your menu should look like the following (date may be different than in image)
Next to test the update, we'll try one of the new host and make sure it plays. Redo the ULR Services Test but use the following URL this time: http://vidspot.net/h144rvyo5mlz
If error then skip to Error Reporting for Updater Test
If all Updater testing passed then please report your success with PMS OS and Version to the beta-testing: Updater Test - Pass thread.
- If error occurs then report issue in the beta-testing: Updater Test - Issues thread, with PMS OS and Version.
- Between USST
v1.0.1andv1.0.2the saved values within the channels data dictionary changed. Before usingv1.0.2make sure to stop PMS, then remove the USST'sDictfrom within the channels support data directory (Dictlocation info can be found here). Then installv1.0.2and start PMS after.