Begin with your distribution’s supported package
Check the current Hypnotix package in your Linux distribution’s software tools and compare its version with the upstream project. The project lists libmpv and other dependencies, so copying only the Python application files is not equivalent to installing a complete supported package.
Record the distribution release and whether the desktop session uses Wayland or X11. These details matter when the application opens but the video surface does not render. Keep package-manager errors separate from playback errors: one concerns installation, while the other occurs after the app is already running.
Choose the matching source type
The upstream README identifies M3U URL, local M3U playlist and Xtream API provider types. Use the form matching what you received, with a descriptive provider name that contains no credentials. A file copied to your computer and a remote URL that updates over time have different maintenance behaviour.
Start with one permitted source. Check whether the provider is saved, whether categories appear and whether one item begins playing. Write down the first missing result. A source name in the sidebar proves that a configuration exists; it does not prove that every network request or media item succeeded.
Keep default content separate from your account
The project describes a default Free-TV provider and allows users to remove it or add other accessible providers. Seeing that default list does not show that your private account has been imported. Conversely, a failure in one default item does not establish that a separately configured provider has failed.
Check the provider selected before reporting a channel. Identically named items can come from different lists. Use the local provider label and the visible channel name in a private support enquiry, while withholding the complete playlist address and account password.
Investigate rendering with the Linux environment in mind
When lists load and sound plays but the picture is absent, record the session type and app/package version before changing your service login. The upstream project documents a Wayland-related workaround; apply any such change only to the affected application and preserve its previous settings. Do not use a rendering workaround as a general network fix.
A successful test should establish ordinary navigation, one live item and any on-demand task you actually need. It cannot establish universal service availability, recording rights or sustained performance on every Linux distribution.