DEV Community

Best IPTV Player
Best IPTV Player

Posted on

Parsing what a publisher README actually promises: a Hypnotix case study

When you build a comparison catalog, the hardest rule to keep is "only record what the publisher says". A README is usually the best primary source for an open-source app, but it is also easy to read more into it than it promises. Here is how we parse one, using Hypnotix, the IPTV player from the Linux Mint project. README checked 18 November 2026. We did not install or run the app.

Step 1: split the README into claim types

We sort every sentence into one of four buckets:

Bucket Hypnotix README says Recorded as
Capability "an IPTV streaming application with support for live TV, movies and series" Live TV / VOD: stated
Input formats "M3U URL", "Xtream API", "Local M3U playlist" M3U: yes, Xtream: yes, local file: yes
Licence "Code: GPLv3"; flags and landing-page icons have separate terms (icons CC BY-ND 2.0) Code licence: GPLv3 (not a statement about content)
Content "Hypnotix does not provide content or TV channels" Content included: no

Anything that fits none of the buckets stays out of the data.

Step 2: separate "requirements" from "platform support"

The README lists requirements (libxapp 2.6+, libmpv, python3-imdbpy, circle-flags) and a Wayland workaround (vo=x11 in the MPV options, GDK_BACKEND=x11 hypnotix). That is strong evidence for Linux desktops. It says nothing about Windows, macOS or Android, so in the data those are unknown, not no.

{
  "player": "hypnotix",
  "platforms": { "linux": "verified", "windows": "unknown", "macos": "unknown", "android": "unknown" },
  "sources": ["https://github.com/linuxmint/hypnotix"],
  "checked": "2026-11-18"
}
Enter fullscreen mode Exit fullscreen mode

Using unknown as a first-class value stops a missing sentence from turning into a negative claim.

Step 3: read the packaging, not just the prose

The README has no install command. The repository's debian/control does tell us the package is named hypnotix and the maintainer is Linux Mint, and debian/changelog shows the latest entry (5.9, 16 November 2026). Linux Mint's own release notes say Hypnotix was new in Linux Mint 20.1. Together, that supports "a Linux Mint application, packaged as hypnotix". It does not support "available in every distro's repositories", so we don't say that.

Step 4: quote defaults neutrally

Hypnotix ships with one default provider, Free-TV. The README explains why: the project says Free-TV includes only free, legal, publicly available content, groups channels by country and has no adult content. We record that as the project's own selection note and attribute it to the project. It is not our rights finding, and we don't copy the playlist.

Step 5: date every fact

Every value carries a source URL and a check date. READMEs change. Hypnotix's repository was updated on 16 November 2026, so a fact recorded in 2024 might not hold now.

Result

The parsed facts are on our Hypnotix page. The same rules run across the whole IPTV player catalog, where "Unknown" means "not stated by the publisher", not "doesn't work".

Sources (checked 18 November 2026): Hypnotix README, debian/control, New features in Linux Mint 20.1.

Top comments (0)