Add Plex accounts
Last updated
Last updated
If you do not plan on managing Plex servers, you can skip this section.
To enable Streams Manager to manage your Plex users and servers, it needs to have access to your Plex accounts. Also, before any of your Plex users can register, at least one Plex account needs to be configured to be able to validate that an email address a user is trying to register with is an email address that is already registered on https://plex.tv.
To add a Plex account, follow these steps:
Click on Plex Accounts in the main menu
Plex Accounts panel will open showing already configured Plex accounts (if any)
Click the menu button in the table header to reveal the action menu and click on Add Plex Account
Modal dialog will show asking you for the following information:
Email - email for your Plex account
Password - (Optional) password for you Plex account. This field is not required to be saved in the system but it is highly recommended to do so. Otherwise, if your Plex token expires or gets invalidated, the system will have no way of generating a new token and all operations the system tries to perform on your Plex account or servers will fail
Authentication token - authentication token (Plex token) used to authorize calls to Plex. To generate the token, you can use the steps outlined in this Plex support article or type in the password in the password field and click on Fetch Token button. NOTE: Fetch token button will not work if you have 2FA enabled on your Plex account
Proxy Url - (Optional but recommended) Url of your proxy server. If provided, Streams Manager will proxy all requests to plex.tv
domain through this proxy. This is an additional security measure to ensure that your account is not accessed from Streams Manager's IP address. You can use any HTTP proxy but it is highly recommended to run the proxy on the same machine where your Plex Media Server is running. This will ensure all traffic appears to be coming from the same machine where Plex Media Server is running.
Proxy username - Username for the proxy. Required if proxy url is specified.
Proxy password - Password for the proxy. Required if proxy url is specified.
Extra query parameters - (Optional but recommended) Extra query parameters to set on calls sent to plex.tv
. The purpose is to make the calls that Streams Manager makes to plex.tv
appear exactly like the calls coming from the Plex web app. To get the query string, follow these steps:
Navigate to https://app.plex.tv and login
Go to Settings (wrench icon)
Open Developer Tools in your browser and open Network
tab
Click on Manage Library Access.
You should see requests in the Network
tab
Find the request that looks like the request in this image:
Copy the request URL and paste in a text editor. Strip everything before and including requests?
. What is left should start with X-Plex-Product
Find the section &X-Plex-Token=xxxxxxx
where xxxxxx
will be your personal token and remove it (do not remove &
after the token)
Copy the remainder and put in the Extra query parameters box in Streams Manager
Has Plex pass - indicates whether this account has Plex pass which is needed to utilize advanced functionality such as streaming enforcement, enabling downloads, etc.
Make sure to test the Proxy settings first before testing your token.
Click Test Token button and ensure you get a success message
Save the Plex account details by clicking the Save button