Identify which login screen you are using
There are two different logins involved in setting up OSM PLAYER. The website’s Manage playlist page identifies your device using its MAC address and 6-digit device key. Your provider’s Xtream Codes login identifies your content account using a server URL, username and password. Entering the right details on the wrong screen will not work.
Open the app to find the MAC address, device key and QR code on its start screen; the details are also available later in Settings. Scan the QR code or open Manage playlist on the website and sign in with those device details. Only then add or edit the playlist using the credentials supplied by your provider.
OSM PLAYER is a player only: it does not sell, host or include channels, films, series or playlists. Its activation is separate from your provider’s account. If you need to confirm which details belong in each playlist field, see the Xtream Codes setup guide. Use content only from a provider you have the right to watch.
Check the server URL, protocol and port
Start with the server field because correct credentials cannot fix the wrong destination. Compare the whole server address with the provider’s latest instructions. Check the hostname, the beginning of the address and any supplied port. Watch for a missing character, a copied space or punctuation accidentally included at the end of a message.
HTTP and HTTPS are not interchangeable fixes. Preserve whichever protocol the provider supplied, together with the port. If an explicit port is removed, HTTP normally uses port 80 and HTTPS uses port 443, which may send the request somewhere different. There is no universal Xtream Codes port you should substitute when a login fails.
The server field is not normally where you paste a complete API request or a full playlist download link. A link containing player_api.php or get.php followed by username and password parameters is different from a server base address. Some setups use a path as part of that base, so do not delete every path component automatically. Ask your provider for the exact server URL to enter.
- 1
Compare the protocol
Check whether the supplied address starts with HTTP or HTTPS. Keep it as supplied unless your provider confirms a replacement.
- 2
Preserve the supplied port
Look for a colon and a number after the hostname. Copy that port exactly; do not remove it or replace it with a number found elsewhere.
- 3
Confirm the server base
If you received only a full login link, ask which address belongs in the server field. If you are troubleshooting an M3U link instead, follow the playlist link troubleshooting steps.
Copy the username and password exactly
Once the server matches, check the username and password as two separate fields. Copy each from the provider’s original message rather than typing from memory. Preserve capitalization, digits and special characters. Remove accidental spaces before or after the value, but do not change characters within the supplied credential.
On a phone, selecting text from a message can include a label, line break or trailing space. Check that you copied only the value, not “Username:” or “Password:” with it. Similar-looking characters can also cause trouble when typed manually. If a password is hidden, use a reveal option if available, and keep the screen private.
Enter the original username and password into their separate fields. Do not manually replace special characters with URL codes or assemble a new login link. Characters can have a different meaning inside a URL, but that is not a reason to alter the password your provider supplied. If the original details are unclear, ask the provider to resend them.
Run Test connection before saving
In OSM PLAYER’s playlist form, press Test connection after correcting the fields. Read the result before saving. If it still fails, record the exact wording and the time of the attempt. A message such as “invalid credentials” or “authentication error” describes a failed login attempt, but without more detail it does not reliably identify which field or account condition caused it.
Opening the server address in a browser is not an equivalent login test. A server can respond without accepting your credentials, and a blank page does not necessarily mean its login service is unavailable. Likewise, a browser message such as “Failed to fetch” can reflect a browser access restriction rather than an incorrect password. Avoid sending your credentials to unrelated online checkers.
- If you see HTTP 403, the request was understood but refused; that code alone does not identify a wrong password.
- If you see HTTP 502, 503 or 504, ask about server availability or upstream problems before editing credentials again.
- If the test gives only a generic failure, retain that wording rather than treating it as proof of expiry.
- Hide passwords, full login links and device keys in screenshots or public messages.
Ask your provider about account status and connection limits
If all three fields match and the test still fails, ask your provider to check the account and server. Send the exact error wording, the time it happened and the server address without embedded credentials. Ask them to confirm the current server URL, protocol and port rather than simply requesting a password reset.
Account status, expiry and simultaneous connection limits are separate checks. Accepted credentials do not necessarily mean playback is allowed, and a playback failure does not by itself prove authentication failed. Ask whether the account is active, whether its expiry date is correct, how many connections are allowed and whether any sessions are still counted as active.
If the playlist is already playing on another device, stop playback there and retry once. Connection-limit enforcement varies by server, so do not assume this will resolve every login error. A provider must confirm account-side restrictions or release a stuck session where applicable. Paying to activate the player does not renew or repair a provider account.
- Is this still the correct server URL, including protocol, port and any required base path?
- Is my account active, and what expiry date does your system show?
- What is my connection allowance, and how many sessions are currently counted?
- Is the login service unavailable or undergoing maintenance?
Refresh the app after saving corrected details
After the connection test succeeds, save the corrected playlist, then press Refresh in the app. Testing checks the entered connection; saving keeps the changes; Refresh asks the app to load the playlist again. If several playlists are saved on your device, make sure you corrected the one you intend to open.
Check that the playlist loads, then try playback. If the catalogue loads but a stream does not play, describe that distinction when asking for help: it is different from a login rejected before the playlist appears. If Test connection continues to fail after your provider confirms the details and account status, contact OSM PLAYER support with the error wording and device type, without posting passwords publicly.
Keep your corrected details somewhere private so you do not paste an older server address the next time you set up a device. If you are setting up the player for the first time, download OSM PLAYER for your device and use the free 7-day trial to check your own provider’s playlist.
- 1
Test the corrected details
Press Test connection in the playlist form. If it fails, resolve the reported problem before treating the setup as complete.
- 2
Save the playlist
Save after the test succeeds so the corrected server and credentials are retained.
- 3
Refresh in the app
Press Refresh, open the intended playlist and check whether it loads and plays.
Published 8 Nov 2026



