Setup notes, a curated news playlist, and tooling for getting Hypnotix TV working on a Mac Mini running Ubuntu (Cinnamon).
Collected over an Oct 2026 troubleshooting session. Everything here was validated
against this box's actual libmpv 0.37 — Hypnotix's real playback engine — not
just "returns HTTP 200".
playlists/
news.m3u Curated news playlist, every channel playback-verified
sync.sh One-shot local sync: pull repo snapshot, refresh upstream
lists, import into Hypnotix (systemd user timer friendly)
scripts/
add_providers.py Writes verified providers into org.x.hypnotix.providers
verify_providers.py Tests candidate providers with Hypnotix's own Manager code
verify_news.py Verifies configured providers + any passed in as args
import_local.py 一键本地秒级导入(推荐): local/file:// 无需下载, --strip-logos 去台标极速模式
classify.py Per-stream libmpv decode test, proxy vs direct comparison
mpv_all.py Authoritative playback matrix (news + YouTube live + baselines)
playback_test.py libmpv probe, requires both video and audio format + time advancing
yttest.py Single YouTube-live stream probe with mpv log dump
durtest.py YouTube channel /live vs @handle/live URL forms
ffcheck.sh ffmpeg/ffprobe batch playback check (CSV: name<TAB>url)
check.sh curl-only playlist HTTP/size/channel-count check
t.sh curl-only quick segment-count check
diag.py mpvopt.py mpv log dump / option-sensitivity probes
init_test.py Can libmpv even init under Hypnotix's flag set?
zbdstest.py Single-stream probe with per-tick property logging
# install what the scripts assume
sudo apt install hypnotix yt-dlp ffmpeg curl
# check the news playlist is healthy before installing it
python3 scripts/verify_news.py
# install the public provider set
python3 scripts/add_providers.py
# 本地快速导入(推荐, 秒级): 用 file:// local 类型，不走网络下载
python3 scripts/import_local.py --list # 查看预设
python3 scripts/import_local.py # 默认导入 News/News-Auto/CN/HK/TW
python3 scripts/import_local.py --all --strip-logos # 全部+去台标极速版(2000+台也不卡)
# 定期更新: 先从上游刷新选中的 m3u 再导入, 并装上 crontab 每 6 小时自动重复
python3 scripts/import_local.py --update --install-cron
# --update 单独用 = 手动刷新一次; --interval-hours 12 改周期;
# --skip-news 跳过 yt-dlp 再生 News-Auto; --uninstall-cron 卸载定时任务
# 日志: 仓库根目录 update.log (超 512KB 自动截尾)
# then verify the channels Hypnotix actually loads
python3 scripts/verify_news.py
# add the news playlist as a local provider
python3 - <<'EOF'
from gi.repository import Gio
s = Gio.Settings.new("org.x.hypnotix")
p = s.get_strv("providers")
n = "News:::local:::file:///path/to/playlists/news.m3u:::::::::"
if n not in p:
s.set_strv("providers", p + [n])
EOFAlways dump dconf before touching it — dconf has no undo:
dconf dump /org/x/hypnotix/ > /tmp/hypnotix_backup_$(date +%Y%m%d_%H%M%S).txtThe mpv scripts write their logs into a scratch dir, defaulting to /tmp/opencode:
mkdir -p /tmp/opencodescripts/verify_news.py resolves playlists/news.m3u relative to the checkout,
or takes NEWS_M3U=/path/to/file.m3u to point somewhere else.
Use watch?v= for YouTube live, not /live. Hypnotix ships mpv 0.37 with
ytdl_hook, which resolves https://www.youtube.com/watch?v=<id> fine but fails
on the https://www.youtube.com/channel/<ID>/live form. Channel /live URLs are
useful for discovering the current live video ID, useless for playing it.
"HTTP 200" is not "live" either. A dead channel can keep serving a frozen
slate forever: CNN's old cnn_slate endpoint returned #EXT-X-ENDLIST, a
MEDIA-SEQUENCE that never advanced, and a PROGRAM-DATE-TIME from 2026-07-20.
scripts/update_playlist.py now fetches every HLS entry, follows one variant of
a master playlist, and marks it dead in status.json when the playlist has
EXT-X-ENDLIST or its live edge is more than an hour behind. Long DVR windows
(BBC keeps two hours) are fine: libmpv still starts at the live edge.
YouTube resolves live ids without yt-dlp when it has to. GitHub Actions
runners get "Sign in to confirm you're not a bot" from yt-dlp, which left every
channel on its cached id for weeks. resolve_live() therefore falls back to
scraping /channel/<id>/live + the watch page and matching the oEmbed author
against the channel handle; cached ids are re-checked before reuse.
"HTTP 200" is not "plays". A lot of news HLS CDNs answer the master playlist
but this box's local HTTP proxy (127.0.0.1:3067) cuts the .ts segment
fetches, so mpv stalls. scripts/classify.py runs every stream both through the
proxy and with it unset so you can tell real breakage from local-environment
breakage. Channels in that state are left commented out in news.m3u.
mpv 0.37 exposes only legacy property names. Use hyphenated
m._get_property("video-format") / "time-pos" — the camelCase shortcuts raise.
audio-format reports "no" on this build even when audio plays fine; confirm
with audio-params and the log line AAC 2ch 48000Hz instead.
Hypnotix provider format is positional. name:::type:::url:::user:::pass:::epg
— six fields, empty ones still need their :. type is url or local; for
local the url field is a file:// path and Hypnotix strips the prefix.
Nothing here contains credentials, tokens or secrets. Stream URLs are public broadcast endpoints.
这个仓库放的是技术实现本身。想看图文并茂的完整折腾记录（踩坑过程、对比测试、效果截图），请关注公众号 绿启未来工坊——每个项目的完整记录都在那里。
- 🌐 网站：www.greenzx.com —— 微型技术服务：小团队系统故障排查 / 轻量化网站搭建 / AI 提效落地
- 💻 全部项目：github.com/zseagate
- ✉️ 联系：zseagate@qq.com
一个人做的硬核交付：代码开源、过程留痕、踩坑记录全公开。