📺 How to Add IPTV Provider

Complete guide to adding IPTV providers to One IPTV Player. Learn about different provider types and how to set them up.

📑 Table of Contents

🎯 Overview

One IPTV Player supports multiple IPTV provider formats, allowing you to add your streaming credentials in various ways. Whether you have an M3U playlist URL, Xtream Codes credentials, MAC Portal access, or a Secure Link, we've got you covered.

✓
Quick Start: Visit the Add Provider page to get started immediately. Your MAC address will be auto-generated for device registration.

Key Features

🔄
Auto-Generated MAC
Unique WEB- prefixed MAC address for device identification
🔐
Secure Storage
Encrypted credentials stored safely on our servers
📱
App Sync
Seamless synchronization with Android app
⏰
Auto-Cleanup
Providers auto-deleted after 48 hours for privacy

📋 Provider Types

One IPTV Player supports four main types of IPTV providers. Here's a quick comparison:

Type Format Complexity Best For
M3U Playlist URL with credentials Easy Simple streaming, direct URLs
Xtream Codes Host + Username + Password Medium Professional IPTV services
MAC Portal Portal URL + MAC Address Medium Device-based authentication
Secure Link Encrypted URL Advanced Enhanced security, encrypted credentials

🔗 M3U Playlist Guide

M3U is the simplest format for adding IPTV providers. It's a playlist format that contains streaming URLs with embedded credentials.

What is M3U?

M3U (MPEG URL) is a standard playlist format used for streaming media. It contains channel information and URLs that point to live streams or VOD content.

Step-by-Step Instructions

1
Get Your M3U URL
Contact your IPTV provider and request your M3U playlist URL. It typically looks like:
http://provider.com/get.php?username=user123&password=pass456&type=m3u_plus
2
Visit Add Provider Page
Go to the Add Provider page and click on the "M3U Playlist" tab.
3
Enter M3U URL
Paste your complete M3U URL in the "M3U Playlist URL" field. Make sure to include all parameters (username, password, type).
4
Optional: Name Your Provider
Enter a friendly name for your provider (e.g., "My IPTV Service"). If left empty, a name will be auto-generated.
5
MAC Address
Enter a device MAC address in format WEB-XXXXXX (e.g., WEB-ABC123). If left empty, one will be auto-generated.
6
Submit
Click "Add M3U Provider" button. Your provider will be saved and you'll receive a confirmation with your MAC address.
ℹ️
M3U URL Format: The URL must contain your username and password as query parameters. Some providers use different parameter names like user and pass instead of username and password.

🖥️ Xtream Codes Guide

Xtream Codes is a professional IPTV server platform. If your provider uses Xtream Codes, you'll have separate credentials for host, username, and password.

What is Xtream Codes?

Xtream Codes is an advanced IPTV streaming platform that provides better performance, more features, and professional management tools compared to simple M3U playlists.

Step-by-Step Instructions

1
Get Xtream Credentials
Contact your IPTV provider and request your Xtream Codes credentials. You should receive:
  • Server URL: http://xtream.example.com:8080
  • Username: your_username
  • Password: your_password
2
Visit Add Provider Page
Go to the Add Provider page and click on the "Xtream Codes" tab.
3
Enter Server URL
Enter the server URL in the "Server URL" field. Include the protocol (http:// or https://) and port number if applicable.
http://xtream.example.com:8080
4
Enter Credentials
Enter your username and password in their respective fields. These are provided by your IPTV provider.
5
Optional: Name Your Provider
Enter a friendly name for your provider. If left empty, a name will be auto-generated.
6
MAC Address
Enter a device MAC address in format WEB-XXXXXX or leave empty for auto-generation.
7
Submit
Click "Add Xtream Provider" button to save your credentials.
⚠️
Important: Xtream Codes servers typically run on port 8080 or 80. Make sure to include the correct port in your server URL.

💻 MAC Portal Guide

MAC Portal authentication uses your device's MAC address instead of username/password. This is common for set-top box providers.

What is MAC Portal?

MAC Portal is a device-based authentication method where your device's MAC address is used to identify and authenticate your access to the IPTV service.

Step-by-Step Instructions

1
Get Portal Information
Contact your IPTV provider and request:
  • Portal URL: http://portal.example.com
  • Your MAC Address: 00:1A:79:XX:XX:XX
2
Visit Add Provider Page
Go to the Add Provider page and click on the "MAC Portal" tab.
3
Enter Portal URL
Enter the portal URL provided by your IPTV provider.
http://mac-portal.example.com
4
Enter MAC Address
Enter your MAC address in one of these formats:
00:1A:79:XX:XX:XX or 00-1A-79-XX-XX-XX
5
Optional: Name Your Provider
Enter a friendly name for your provider.
6
Device MAC Address
Enter your device's MAC address in format WEB-XXXXXX for identification.
7
Submit
Click "Add MAC Portal" button to save.
ℹ️
MAC Address Format: MAC addresses can use either colons (:) or hyphens (-) as separators. Both formats are accepted.

📱 Android App Integration

Once you've added a provider on the website, you can sync it with the One IPTV Player Android app using your Device ID.

How It Works

The Android app uses a unique Device ID to sync providers from the website. When you add a provider on the website, it's stored with your Device ID and can be retrieved by the app.

Syncing Providers to Android App

1
Get Your Device ID
Open One IPTV Player on your Android device and navigate to Settings → Device Information. Your Device ID will be displayed there.
2
Add Provider on Website
Add your IPTV provider using the Add Provider page as described above.
3
Use "Add from Device ID" in App
In the Android app, go to Add Provider → Add from Device ID. Enter your Device ID to retrieve providers you've added on the website.
4
Select and Add
The app will display all providers associated with your Device ID. Select the provider you want to add and confirm.

Android App Provider Types

The Android app supports the same provider types as the website:

🔗
M3U Playlist
URL with credentials
🖥️
Xtream Codes
Host + Username + Password
💻
MAC Portal
Portal URL + MAC Address
🔐
Secure Link
Encrypted URL
ℹ️
Device ID: Your Device ID is a unique identifier for your Android device. It's used to sync providers between the website and the app. Keep it safe and don't share it with others.

🔧 Troubleshooting

Common Issues and Solutions

❌ Invalid M3U URL format
Solution: Make sure your M3U URL includes the protocol (http:// or https://) and all required parameters. Example: http://provider.com/get.php?username=user&password=pass&type=m3u_plus
❌ Invalid MAC address format
Solution: MAC addresses must be in format XX:XX:XX:XX:XX:XX or XX-XX-XX-XX-XX-XX where X is a hexadecimal digit (0-9, A-F).
❌ Provider already exists
Solution: A provider with the same credentials is already in the system. The system will update the existing provider with new information.
❌ Failed to decrypt secure link
Solution: The Secure Link URL is invalid or corrupted. Make sure you copied the entire URL correctly from your provider.
❌ No channels loading in app
Solution: Verify your credentials are correct, check if your provider subscription is active, try testing the URL in a web browser, and ensure your internet connection is stable.
❌ Cannot sync from Device ID
Solution: Make sure you entered the correct Device ID, verify that providers were added with this Device ID, check your internet connection, and try again after a few minutes.

❓ FAQ

What is a MAC address and why do I need one? ▼
A MAC (Media Access Control) address is a unique identifier for your device on a network. In IPTV systems, it's used to identify and authenticate your device. The system auto-generates a WEB- prefixed MAC address for you, but you can also provide your own.
How long are my providers stored? ▼
Providers are automatically deleted after 48 hours for privacy and security reasons. This is a temporary storage system. For permanent storage, save your credentials securely or use the app's local storage feature.
Can I use the same provider on multiple devices? ▼
Yes, you can add the same provider credentials on multiple devices. Each device will have its own MAC address for identification. However, check your provider's terms for connection limits.
What's the difference between M3U and Xtream Codes? ▼
M3U is a simple playlist format with embedded credentials in the URL. Xtream Codes is a more advanced platform that provides better performance, more features, and professional management. Xtream typically requires separate host, username, and password.
Is my password secure? ▼
Yes, your credentials are stored securely in our database. Secure Links use encryption for additional protection. However, we recommend using strong, unique passwords and not sharing your credentials with others.
Can I edit a provider after adding it? ▼
Currently, you can update a provider by adding it again with the same credentials. The system will update the existing entry with new information like name and MAC address.
What if I forget my Device ID? ▼
You can find your Device ID in the Android app under Settings → Device Information. It's a unique identifier for your device that you can view anytime.
Can I use custom MAC addresses? ▼
Yes, you can provide your own MAC address in the format WEB-XXXXXX (where X is alphanumeric). If you leave it empty, the system will auto-generate one for you.
What should I do if my provider stops working? ▼
First, verify your credentials are correct and your subscription is active. Test the URL in a web browser if possible. If the issue persists, contact your IPTV provider's support team. You can also try removing and re-adding the provider.

Ready to Get Started?

Add your IPTV provider now and start streaming with One IPTV Player!

➕ Add Provider Now