Blogs

Onyx IPTV Player: Windows Setup, M3U, and Xtream Explained

Onyx IPTV can refer to several different products, which makes the search term more confusing than it first appears. For Windows users, there is a dedicated Onyx IPTV player designed for user-supplied M3U playlists, Xtream accounts, and XMLTV programme guides. It runs as a desktop IPTV client and does not include television channels or an IPTV subscription.

Swedish search results also show an Onyx Android TV box and an Android app called OnyxPlay IPTV. These are separate products, so the installation instructions in this guide focus specifically on the Windows Onyx player.

What Is Onyx IPTV for Windows?

The Windows version of Onyx is a local-first IPTV player built for people who already have their own authorised IPTV source.

It currently supports:

Local M3U and M3U8 files
Remote M3U playlist URLs
Xtream account profiles
Live TV
Movies and series through compatible Xtream sources
XMLTV EPG guides
Favourites
Recent channels
Channel-group management
Search
Resume playback

Playback is handled through native libmpv rather than through a browser-based video element.

The application is focused on Windows, making it relevant for users who prefer watching IPTV on a desktop computer, laptop, or Windows PC connected to a television.

Do Not Confuse the Different Onyx IPTV Products

This is particularly important for users searching from Sweden.

Satpro currently sells Onyx-branded Android TV hardware. Its Onyx boxes use Android-based software and a NOX media interface. That hardware is separate from the open-source Windows application covered in this guide.

Google Play also lists OnyxPlay IPTV from Esto Networks as an Android application. That app is again a different product from the Windows Onyx player.

Before downloading anything, check:

Operating system
Developer name
App store or download source
Login method
Whether you need a player or a physical IPTV box

Following setup instructions for the wrong Onyx product can lead to unnecessary account and compatibility problems.

How to Install Onyx IPTV on Windows

The Onyx project currently recommends its Microsoft Store release for supported Windows installation. Standalone MSI and NSIS installers are also available through its release repository.

The Windows setup is generally:

Install Onyx.
Open the application.
Go to Settings > Sources.
Choose M3U, a local playlist, or Xtream.
Enter your authorised source information.
Select Load Now.
Open Live TV or another available media section.

Current documentation says recent Windows 10 and Windows 11 installations normally already include the Microsoft Edge WebView2 runtime the application uses.

If you need general guidance about different IPTV credential types, the IPTV installation guides explain common setup formats across players and devices.

How to Add an M3U Playlist

Onyx supports both remote M3U URLs and local M3U or M3U8 files.

For a remote playlist:

Open Settings.
Select Sources.
Choose the M3U source option.
Add the complete playlist URL.
Save the source.
Select Load Now.
Open Live TV after the playlist has loaded.

Do not shorten or edit the playlist address unless your provider specifically tells you to.

An M3U URL can contain information such as:

Server address
Username
Password
Output format
Account-specific identifiers

Treat the full URL as private account information.

Using a Local M3U File

You can also import an M3U or M3U8 file stored on the Windows computer.

A local playlist can be useful if you maintain your own authorised stream list or want to test a specific set of channels without relying on a remote playlist file.

The player still needs internet access if the actual streams point to online servers.

How Xtream Setup Works in Onyx

Onyx also supports Xtream profiles.

An Xtream-style account normally contains:

Server address
Username
Password

After adding the profile under Settings > Sources, select Load Now.

Current Onyx documentation says compatible Xtream profiles can populate Live TV as well as Movies and TV Shows when those categories are supplied by the provider.

Using Xtream rather than M3U does not automatically improve stream quality. The two methods mainly change how the player receives and organises account information.

If your provider gives you only an M3U URL, use M3U unless the provider also supplies separate Xtream credentials.

M3U vs Xtream on Onyx

The better option depends on what your IPTV service provides.

M3U is useful when:

You receive one playlist URL
You have a local playlist file
You mainly need live channels
You want a simple source format

Xtream is useful when:

You receive a server, username, and password
Your provider separates live TV, movies, and series
You want structured categories
You prefer keeping account details as a saved profile

Onyx supports both, so there is usually no need to convert credentials through third-party websites.

How EPG Works

Onyx supports XMLTV programme-guide sources.

The current setup process lets users add one or more XMLTV URLs under Settings > EPG, update the guide, and manually associate channels with EPG listings when automatic matching does not work.

If your channels work but the EPG is empty, check:

Whether your IPTV service provides XMLTV data
Whether the EPG URL is complete
Whether the guide has been updated
Whether channel names match the guide
Whether manual mapping is required
Your Windows timezone

For users in Sweden, the computer should normally use the Europe/Stockholm timezone.

How Onyx Handles Large Channel Lists

Large IPTV libraries can become difficult to navigate on a desktop player.

Onyx currently provides search and separate visibility controls for Live TV, Movies, and TV Show groups. The player also keeps its navigation, group list, and TV guide accessible together to make larger libraries easier to browse.

You can also use favourites and recent items instead of repeatedly navigating through the entire playlist.

This is particularly useful when a provider supplies many countries or categories but you mainly watch Swedish and Nordic channels.

Privacy and Credential Storage

One unusual aspect of the Windows Onyx player is its local-first design.

The project states that it does not use a cloud backend, analytics, telemetry, or account synchronisation. Playlist and application data remain on the Windows machine apart from requests made directly to the IPTV and EPG sources configured by the user.

The project also says remote M3U URLs, EPG URLs, and Xtream passwords are stored through Windows Credential Manager rather than inside ordinary application-state files.

That does not remove the need to protect your credentials. Avoid sharing screenshots containing server URLs, usernames, passwords, or complete M3U links.

Does Onyx IPTV Include Channels?

No.

The Windows project explicitly states that Onyx is a client for user-supplied playlists, streams, Xtream accounts, and EPG sources. It does not provide television channels, IPTV subscriptions, playlists, or service access.

The setup therefore has two separate components:

Onyx: the Windows media player.

IPTV service: the source that supplies your authorised channels and credentials.

Installing the app without adding a source will not create a television package.

If you are comparing IPTV applications and services for Sweden, Rapid IPTV Sweden provides another Sweden-focused reference.

Playlist Loads but Channels Do Not Play

A successful playlist import does not guarantee that every stream will play.

If the channel list appears but playback fails:

Test several channels.
Restart Onyx.
Reload the source.
Check your internet connection.
Confirm the subscription is active.
Test the same authorised source in another compatible player if your provider permits it.

Onyx uses libmpv for playback, so it supports a broad media-player workflow, but the original stream still needs to be reachable and usable.

If only one channel fails, the issue may be limited to that stream.

Xtream Login Does Not Work

If an Xtream profile will not connect, check each field carefully.

Common mistakes include:

Wrong protocol
Missing port
Extra spaces
Incorrect username
Incorrect password
Expired subscription
Old server address

Enter the server information exactly as supplied.

Do not add /c/, /get.php, or another path unless it is genuinely part of the login format provided to you.

For more general troubleshooting, the Viking IPTV FAQ covers common connection and account questions.

What Swedish Users Should Check

Before choosing Onyx as your regular Windows IPTV player, verify:

You are downloading the Windows Onyx player, not another product with the same name
Your computer runs a supported Windows version
Your IPTV service supplies M3U or Xtream credentials
Swedish channel names display correctly
EPG timing matches Europe/Stockholm
Subtitle and audio tracks work with your streams
Your provider allows the way you intend to use the account
Your credentials are stored securely

If your main television uses Android rather than Windows, an Onyx Android box or another TV-focused player may represent a completely different setup.

FAQ

What is Onyx IPTV?

For Windows users, Onyx IPTV is a desktop IPTV player that can load M3U, M3U8, Xtream, and XMLTV sources. It does not provide television channels.

Does Onyx IPTV work on Windows?

Yes. Windows is currently the primary supported platform for the open-source Onyx player.

Can Onyx use M3U playlists?

Yes. It supports remote M3U URLs as well as local M3U and M3U8 files.

Does Onyx support Xtream?

Yes. Current versions support Xtream profiles for compatible Live TV, Movies, and TV Shows sources.

Can I add an EPG to Onyx?

Yes. Onyx supports XMLTV guide URLs and manual channel-to-EPG matching.

Is the Onyx IPTV Windows app the same as the Onyx box sold in Sweden?

No. Swedish retailers sell Onyx Android TV hardware, while the Windows Onyx player is a separate software project.

Is OnyxPlay IPTV on Google Play the same application?

No. OnyxPlay IPTV on Google Play is published by Esto Networks and is a separate Android product.

Final Thoughts

Onyx IPTV is a practical Windows option for users who already have an authorised M3U playlist, Xtream account, or XMLTV guide. Its Windows-focused interface, local source management, EPG tools, favourites, search, and native playback make it distinct from both generic browser players and the unrelated Onyx Android products that also appear in Swedish search results.

If you are preparing Onyx on a Windows PC and need compatible IPTV subscription information for use in Sweden, visit Viking IPTV to review the available service and setup details.