Skip to content

Releases

聚合视频 v1.3.2

Choose a tag to compare

@github-actions github-actions released this 21 Oct 02:14

聚合视频 v1.3.2 —— 桌面界面重做 + Android 12 兼容(全平台)

Android · macOS · Linux(Arch / Fedora / openSUSE / Debian / Ubuntu / NixOS / Gentoo)
GPL-3.0-only

📱 Android 兼容范围扩大(重要)

最低支持从 Android 15 降到 Android 12(API 31),覆盖更多设备;返回键迁移 OnBackPressedDispatcher
(手势/三键行为统一,旧系统不再失效)。要求:Android 12+(arm64-v8a)。

🖥 桌面端界面重做(Linux/macOS 视觉统一)

设计 token(17 个颜色角色 × 明暗两套)+ Material Symbols 图标 + 组件库;等高 16:9 卡片网格;
macOS 同步落地(不透明底/图标字体/胶囊搜索框)。scripts/check-ui.py 保证界面只走 token。

🌟 新功能:搜索历史(三端)

空搜索词时显示历史词条(最多 15 条,去重置顶),点词条立即再搜;设置里可开关/清空,纯本地存储。

🐛 重要修复

  • 拖动进度条后停播:seek 瞬间被误判"播放结束"→ 自动切条且画面冻结(Android);三端 mpv 增加
    network-timeout 与断线重连
  • YouTube 画质受限:SABR 实验下默认客户端只给 360p → web_safari 备选 + 档位不足自动带 cookie 重试
    • "请求 2K 实际 1080p"如实提示
  • 「点下一个视频出错」:YouTube 搜索混入频道/播放列表条目 → 过滤 + 失败自动跳过(三端)
  • 字幕「时有时无」:切歌不刷新字幕轨等四根因(Android)
  • B站搜索标题 HTML 实体与时长格式(如 419:2 → 6:59);macOS 输入即搜改为回车触发
  • Linux 隐藏来源下拉框偶发浮出压住搜索框

🙏 特别鸣谢

  • @Zakkaus:桌面端 splitter/封面比例/B站标题时长四项修复(PR #3),
    以及整套桌面界面重做(设计 token + Material Symbols + 组件库 + check-ui 检查)—— 本版桌面端的
    新面貌主要出自他手
  • @lishoujun:v1.3.0 的 YouTube 直链代理与播放链贡献

📦 安装

平台 方式
Android 12+(arm64) Releases 下载 hov-1.3.2-arm64.apk
macOS(Apple 芯片) Releases 下载 HyperOnlineVideo-1.3.2-arm64.dmg
Arch / Manjaro AUR:yay -S hov-qt(1.3.2-1)
Fedora 44/45 sudo dnf copr enable houge/hov-qt && sudo dnf install hov-qt
openSUSE(TW / Leap) OBS home:houge(x86_64 / aarch64 / riscv64)
Gentoo gentoo-zh overlay:media-video/hov-qt
Debian / Ubuntu Releases 下载 deb
任意发行版 Releases 下载 AppImage
NixOS flake:github:HougeLangley/HyperOnlineVideo
容器制品 oras pull ghcr.io/hougelangley/hov-qt:1.3.2

完整变更:desktop/packaging/deb/debian/changelog 与提交历史。

聚合视频 v1.3.1 —— 字幕「时有时无」与「下一个视频出错」双根治(全平台)

Choose a tag to compare

@HougeLangley HougeLangley released this 16 Oct 14:27

聚合视频 v1.3.1 —— 稳定性修复版(全平台)

Android · macOS · Linux(Arch / Fedora / openSUSE / Debian / Ubuntu / NixOS)
发布日期:2026-10-17 · GPL-3.0-only

🐛 重点修复

Android(用户实测反馈 ✓)

  • 字幕「时有时无」根治:逐字排查出四个根因并全修 ✓
    ① 切歌/连播从不刷新在线字幕轨(首条有字幕、连播后消失 ✗)
    ② 字幕二次解析总带失效 cookie → 改为匿名优先、cookie 重试 ✓
    ③ 多语言视频中文轨被无序截断丢弃 → 按系统语言排序收集 ✓
    ④ B站字幕退避重试 2 → 3 次 ✓
  • 「点下一个视频出错」根治:YouTube 搜索结果混入频道/播放列表条目 ✗
    → 搜索侧过滤非视频形态 ✓ + 切歌失败自动跳过(上限 5 ✓ 方向感知 ✓)

🛡 稳健性(三端对齐)

  • macOS / Linux 同类潜患一并消除:
    • macOS:视频解析失败自动 tryPlayNext(前进最多 6 条 ✓)
    • Linux:新增解析失败回调 → 队列驱动失败自动跳过(上限 5 ✓ 超时不回调防风暴 ✓)
  • 三端行为统一:队列中任何不可播放条目都会自动跳过并在界面说明 ✓

⚙️ 工程与依赖

  • Kotlin/Compose 插件 2.2.20 → 2.4.21(编译 0 告警 ✓)
  • Gradle 9.8.1 · AGP 9.4.1 · coroutines 1.11.0 · org.json 20260814
  • CI:GHCR(GitHub Packages)产物发布 ✓ · 自托管 runner ✓ · 发布人工闸门 ✓

📦 安装

平台 方式
Android 15+ Releases 下载 hov-1.3.1-arm64.apk(arm64-v8a ✓)
macOS(Apple 芯片) Releases 下载 HyperOnlineVideo-1.3.1-arm64.dmg(首次打开需右键→打开 ✓)
Arch / Manjaro AUR:yay -S hov-qt(hov-qt 1.3.1-1 ✓)
Fedora 44/45 sudo dnf copr enable houge/hov-qt && sudo dnf install hov-qt
openSUSE(TW / Leap) OBS home:houge
Debian / Ubuntu Releases 下载 hov-qt_1.3.1-1_amd64.deb
任意发行版 Releases 下载 HyperOnlineVideo-x86_64.AppImage
NixOS flake:github:HougeLangley/HyperOnlineVideo

🔎 验证

  • Android:真机(小米 2509FPN0BC)字幕链 580/477 条实测 ✓ 连点 ⏭ ×3 全通过 ✓
  • macOS:自检 119/119 ✓ 用户实测通过 ✓
  • Arch Linux ARM VM:全新构建 ✓ GUI 截图验收 ✓ 自测零失败 ✓
  • CI:三端门禁全绿 ✓

完整更新日志:见仓库 desktop/packaging/deb/debian/changelog · git log

聚合视频 v1.3.0 —— 社区协作里程碑(fork 整合 + YouTube 全链修复 + 字幕三端统一)

Choose a tag to compare

@HougeLangley HougeLangley released this 08 Oct 10:25

聚合视频 v1.3.0 —— 社区协作里程碑(fork 整合 + YouTube 全链修复 + 字幕三端统一)

这是一个由社区协作促成的大版本:全部平台(Android / macOS / Linux)的 YouTube 播放链、字幕链完成系统性修复;
三端行为全面对齐;代码经四维审核(重复/硬编码/重复块/未启用代码)达标。
Linux 端全部通过官方软件源安装(一键命令、自动更新),第一节即为完整安装指南。


🙏 特别鸣谢:lishoujun 的 fork 贡献(本版整合)

本版直接整合并完整保留署名了 @lishoujun 在其 fork 中的 14 个高质量提交,
其中多项是关键问题的根治方案:

贡献 解决的问题
YtRangeProxy(分块 Range 本机中继) 受限网络出口(VPS/数据中心 IP)下 googlevideo 直链 403 → 彻底修复
player_client=web_embedded 客户端策略 android_vr 客户端"10MB 墙"(播十几秒断流)
DASH 音频 mpv NODE 数组挂载 + 路径转义 分离音轨挂载竞态(并附 143 行 Python 回归测试)
点击立即取消上一次解析 + 字幕后台抓取 连续点击卡顿、解析叠加
CLI --help / --version 命令行可用性
GitHub Actions CI 工作流 自动化构建基础

感谢这份贡献 —— 协作让这个项目变得更好。上游将持续跟进并欢迎更多 PR。


一、下载与安装(完整指南 · 复制粘贴即可)

📱 Android(手机 / 平板)

  1. 下载本页 Assets → app-release-1.3.0.apk
  2. 手机打开安装;若提示"禁止安装未知应用",按提示允许(标准流程)
  3. 需 Android 15(API 35)+;应用内「设置 → 关于」确认版本 1.3.0

🍎 macOS(Apple 芯片 M 系列)

  1. 下载 Assets → HyperOnlineVideo-1.3.0-arm64.dmg
  2. 打开 DMG → 拖入「应用程序」
  3. 首次打开被拦(未公证):右键→打开;或终端:
    sudo xattr -dr com.apple.quarantine /Applications/HyperOnlineVideo.app

🐧 Linux(按发行版选择)

Arch Linux / Manjaro / EndeavourOS(AUR · clang 构建)

sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git /tmp/yay && cd /tmp/yay && makepkg -si   # 已装 yay/paru 可跳过
yay -S hov-qt

Fedora 44 / 45(COPR)

sudo dnf copr enable houge/hov-qt
sudo dnf install hov-qt

openSUSE Tumbleweed

sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Tumbleweed/ obs-houge
sudo zypper install hov-qt

openSUSE Leap 16.0

sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Leap_16.0/ obs-houge-leap
sudo zypper install hov-qt

Ubuntu 26.04(OBS 仓库 · x86_64/aarch64)

echo "deb https://download.opensuse.org/repositories/home:/houge/Ubuntu_26.04/ ./" | sudo tee /etc/apt/sources.list.d/hov-qt.list
curl -fsSL https://download.opensuse.org/repositories/home:/houge/Ubuntu_26.04/Release.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/hov-qt.gpg
sudo apt update && sudo apt install hov-qt

Debian 13(OBS 仓库 · x86_64/aarch64)

echo "deb https://download.opensuse.org/repositories/home:/houge/Debian_13/ ./" | sudo tee /etc/apt/sources.list.d/hov-qt.list
curl -fsSL https://download.opensuse.org/repositories/home:/houge/Debian_13/Release.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/hov-qt.gpg
sudo apt update && sudo apt install hov-qt

任意发行版(便携):下载 HyperOnlineVideo-aarch64.AppImage → chmod +x → 直接运行

NixOS(flake)

# flake.nix inputs 中:
hov-qt = { url = "github:HougeLangley/HyperOnlineVideo"; inputs.nixpkgs.follows = "nixpkgs"; };
# configuration.nix:
environment.systemPackages = [ inputs.hov-qt.packages.x86_64-linux.default ];
sudo nixos-rebuild switch

二、本版亮点

🎬 YouTube 冷启动播放修复(三端)

  • 症状:冷启动后点第一个视频不播/无声/无画面;后续正常
  • 根因(Android 日志实锤):音频挂载是固定延时命令,与首帧加载竞态;且选流优先 HLS 主清单(常无音轨)
  • 修复:音频改事件驱动(file-loaded ✓ 幂等 ✓);macOS 采用 audio-files 预挂载(Linux 同款);优先 DASH 分轨,HLS 仅兜底

💬 字幕链三端统一(含中文自动翻译)

  • 语言判断:严格取系统语言(Locale,与网络出口无关);按系统语言优先级排序 → 默认显示
  • 中文:支持 YouTube 自动翻译轨(语言码实为 zh-Hans-en);轨名规范显示为 zh-Hans(翻译)
  • 抗限流:匿名优先 → cookie 重试 → 429 退避重试;macOS 两步法(先取可用语言再下载 ≤2 条)
  • 根治"多语言齐发被拒":改 yt-dlp 正则匹配(只请求真实存在的轨)

⚡ 画质与解析对齐

  • 撤销强制客户端;匿名优先解析(失效 cookie 会触发 YouTube 降级);实测 1080p/1440p 正常选中

🧹 工程质量

  • 日志时间前缀(hh:mm:ss);解析超时 75s;四维代码审核(重复/硬编码/重复块/未启用代码)达标;三端告警清零(平台性残留有据记录)

三、完整更新日志(自 v1.2.5 起)

  • 整合 fork 14 提交(YtRangeProxy / web_embedded / DASH NODE / cancel-inflight / CLI / CI)
  • YouTube 冷启动影音修复(Android 事件驱动 · mac 预挂载 · DASH 优先)
  • 字幕三端统一(系统语言 · 中文翻译轨 · 匿名优先 · 429 退避 · 两步法)
  • 画质对齐(撤销客户端强制 · 匿名优先)
  • 代码审核与告警清理(三端)

四、已知问题

  • 受限出口(VPS/数据中心 IP):仅影响 YouTube 直链 → 已由 YT-PROXY 分块中继缓解;极端情况请更换线路
  • Ubuntu 24.04 / Debian 12:Qt < 6.5 暂不支持(请用 26.04 / 13 或 AppImage)
  • Apple 公证:macOS 应用未付费公证,首次打开按第一节处理

五、致谢

@lishoujun(fork 关键贡献 · 本版核心修复来源)· 所有提交 Issue 与实测反馈的用户 —— 这个版本属于社区。

聚合视频 v1.2.5 —— YouTube 直链可播性预检 + 全平台出口指引 + 日志时间前缀

Choose a tag to compare

@HougeLangley HougeLangley released this 01 Oct 16:26

聚合视频 v1.2.5 —— YouTube 直链可播性预检 + 全平台出口指引 + 日志时间前缀

修复性更新:针对受限网络出口(VPS/数据中心 IP)导致的 YouTube「解析成功但无法播放(403)」,
新增可播性预检与明确指引(Linux / macOS / Android 三端 ✓);全部日志加入时间前缀 ✓。

一、本版亮点

🔎 YouTube 直链可播性预检(Issue #1 ✓ 三端)

  • 背景:部分出口被 YouTube 施加“仅探测”策略(>64KB 的 Range 一律 403 ✗)→ 解析成功但 mpv 打不开 ✗
  • 修复:交给播放器前先做 4MB Range 探针(正常 200/206 ✓;受限 403 ✗)→ 命中即明确提示更换代理节点/线路 ✓
  • 覆盖:Linux(Qt 桌面)· macOS · Android(Toast ✓)

🕒 日志时间前缀(社区建议 ✓)

  • 所有日志统一 [HH:MM:SS] 前缀(含 qInfo/qWarning 与 stderr ✓)——排障对照更直观 ✓

二、下载与安装

安装方式与 v1.2.4 相同:Android APK / macOS DMG / Arch(AUR)/ Fedora(Copr)/ openSUSE(OBS)/ Ubuntu 26.04 / Debian 13 / AppImage / NixOS ✓
(详细命令见 v1.2.4 说明或仓库 README ✓)

三、更新日志(自 v1.2.4 起)

  • 三端:YouTube 直链 4MB Range 预检 + 受限出口指引 ✓
  • 桌面端:64 处 stderr 日志 + qInfo 全量时间前缀(hovLog / messageHandler ✓)
  • 工程:Issue #1 根因定位与复现实验(出口策略 ✗ 非应用缺陷 ✓)

四、已知问题

  • 受限出口(VPS/数据中心 IP)下仅有提示、无法解除媒体封锁 ✗(YouTube 服务端策略 ✓)→ 请更换代理线路 ✓
  • Ubuntu 24.04 / Debian 12(Qt < 6.5)暂不支持 ✓

聚合视频 v1.2.4 —— QQ 音乐歌词修复 + clang 全平台构建(Android / macOS / Linux 全平台)

Choose a tag to compare

@HougeLangley HougeLangley released this 01 Oct 13:07

聚合视频 v1.2.4 —— QQ 音乐歌词修复 + clang 全平台构建(Android / macOS / Linux 全平台)

本次为修复性更新:修复 QQ 音乐在部分环境下"歌词全黑不显示"的问题;代码经 clang 全面净化;
Linux 全渠道改用 clang/llvm 构建,并新增 Ubuntu / Debian 官方构建仓库 ✓。
Linux 端全部通过官方软件源安装(一键命令、自动更新 ✓),第一节即为完整安装指南。


一、下载与安装(小白也能看懂 · 复制粘贴即可)

📱 Android(手机 / 平板)

  1. 在本页下方 "Assets" 区域点击 app-release-1.2.4.apk 下载
  2. 在手机上打开该文件;若提示「禁止安装未知应用」,按提示允许(安卓装非商店应用的标准流程 ✓)
  3. 安装完成后,桌面出现「聚合视频」图标即成功 ✓

要求 Android 15(API 35)及以上 ✓ 应用内「设置 → 关于」可确认版本为 1.2.4 ✓

🍎 macOS(Apple 芯片 M 系列)

  1. 在 "Assets" 区域下载 HyperOnlineVideo-1.2.4-arm64.dmg
  2. 双击打开 → 把「聚合视频」拖进 应用程序 文件夹
  3. 第一次打开会被 macOS 拦下(未付费公证的应用都会这样 ✓ 正常现象):
    • 方法 A:右键点图标 → 选「打开」→ 再点一次「打开」
    • 方法 B(推荐):打开「终端」粘贴:
      sudo xattr -dr com.apple.quarantine /Applications/HyperOnlineVideo.app

🐧 Linux —— 按你的发行版选一条(全部为软件源安装 ✓)

Arch Linux / Manjaro / EndeavourOS

# ① 还没装 AUR 助手的话先装 yay(已有 yay/paru 就跳过)
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git /tmp/yay && cd /tmp/yay && makepkg -si

# ② 安装(首次自动编译约 2-3 分钟;用 clang/llvm 构建 ✓)
yay -S hov-qt

Fedora 44 / 45

sudo dnf copr enable houge/hov-qt
sudo dnf install hov-qt

Ubuntu 26.04

sudo add-apt-repository -y ppa:houge/hov-qt 2>/dev/null || true   # 若提示无此 PPA 请看下行
echo "deb https://download.opensuse.org/repositories/home:/houge/Ubuntu_26.04/ ./" | sudo tee /etc/apt/sources.list.d/hov-qt.list
curl -fsSL https://download.opensuse.org/repositories/home:/houge/Ubuntu_26.04/Release.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/hov-qt.gpg
sudo apt update && sudo apt install hov-qt

Debian 13

echo "deb https://download.opensuse.org/repositories/home:/houge/Debian_13/ ./" | sudo tee /etc/apt/sources.list.d/hov-qt.list
curl -fsSL https://download.opensuse.org/repositories/home:/houge/Debian_13/Release.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/hov-qt.gpg
sudo apt update && sudo apt install hov-qt

openSUSE Tumbleweed

sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Tumbleweed/ obs-houge
sudo zypper install hov-qt

openSUSE Leap 16.0

sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Leap_16.0/ obs-houge-leap
sudo zypper install hov-qt

NixOS(声明式 · flake)

在 /etc/nixos/flake.nix 的 inputs 里加:

hov-qt = {
  url = "github:HougeLangley/HyperOnlineVideo";
  inputs.nixpkgs.follows = "nixpkgs";
};

在 configuration.nix(或 home-manager 的 home.nix)里加:

environment.systemPackages = [ inputs.hov-qt.packages.x86_64-linux.default ];

然后重建:

sudo nixos-rebuild switch

首次编译约 5 分钟 ✓ WebEngine 登录窗在 NixOS 下默认不链接(登录请手动放置 cookie 文件,与应用内说明一致 ✓)


二、本版亮点(v1.2.4 更新内容)

🎵 QQ 音乐歌词修复(核心修复 ✓)

  • 问题:部分用户播放 QQ 音乐时右栏全黑、无标题无歌词(网易云正常 ✗)
  • 根因:QQ 登录 cookie 文件随时间累积到 15KB 后,请求头超限,歌词接口(c.y.qq.com)直接拒绝连接(HTTP 000)
  • 修复:歌词请求改为匿名优先;为空再用"按完整条目截断到 3KB"的 Cookie 重试一次 ✓
  • 覆盖:macOS + Linux(Android 走新版接口,不受影响 ✓)

🧹 代码净化(clang 全净)

  • 移除死字段 1 处 + 未使用的 lambda 捕获 4 处;clang -Wextra 告警数 5 → 0 ✓
  • 全平台等价重构,行为零变化 ✓

🐧 Linux 构建体系升级

  • 全渠道改用 clang/llvm 构建(clang + lld ✓):Arch / Fedora(COPR) / openSUSE(OBS) / Ubuntu / Debian ✓
  • 新增 Ubuntu 26.04 与 Debian 13 官方构建仓库(x86_64 + aarch64 ✓ 一键安装 ✓)
  • 实测:openSUSE Tumbleweed x86_64/aarch64/riscv64、Leap 16.0、Ubuntu 26.04、Debian 13 全目标构建成功 ✓

三、完整更新日志(自 v1.2.3 起)

  • QQ 音乐:歌词全黑修复(匿名优先 + 截断 Cookie 重试;macOS/Linux 同修)
  • 代码:清理死字段 + 未用捕获(clang -Wextra 零告警)
  • 构建:全 Linux 渠道 clang/llvm 化;新增 Ubuntu/Debian 构建仓库
  • 工程:新增 riscv64 deb 构建;全平台复验(Android 真机 / macOS 119/119 自测 / Linux E2E)

四、已知问题与说明

  • B站登录:部分功能(1080P+/字幕等)需登录;若搜索异常,请在应用内重新登录 B 站 ✓
  • Apple 公证:macOS 应用未做付费公证,首次打开需按第一节方法绕过(正常现象 ✓)
  • QQ 音乐:若提示"需重新登录",在应用内「登录」页重新登录即可 ✓
  • Ubuntu 24.04 / Debian 12:Qt 版本低于 6.5,暂不支持(请升级系统或使用 AppImage ✓)

五、致谢

感谢真实使用场景中的每一条反馈 —— 本版的 QQ 歌词修复正是来自用户的对比测试与截图 ✓
发现问题欢迎开 Issue ✓

聚合视频 v1.2.3 —— B站搜索升级(wbi 签名)+ 稳定性维护(Android / macOS / Linux 全平台)

Choose a tag to compare

@HougeLangley HougeLangley released this 28 Sep 07:27

聚合视频 v1.2.3 —— B站搜索升级(wbi 签名)+ 稳定性维护(Android / macOS / Linux 全平台)

本次为维护性更新:B 站搜索升级为官方现行 wbi 签名协议(解析更稳、抗风控 ✓);
Android 端"播完自动连播"加固;并完成 yt-dlp 版本与四平台 API 的全面核查 ✓。
Linux 端全部通过官方软件源安装(一键命令、自动更新 ✓),第一节即为完整安装指南。


一、下载与安装(小白也能看懂 · 复制粘贴即可)

📱 Android(手机 / 平板)

  1. 在本页下方 "Assets" 区域点击 app-release-1.2.3.apk 下载
  2. 在手机上打开该文件;若提示「禁止安装未知应用」,按提示允许(安卓装非商店应用的标准流程 ✓)
  3. 安装完成后,桌面出现「聚合视频」图标即成功 ✓

要求 Android 15(API 35)及以上 ✓ 应用内「设置 → 关于」可确认版本为 1.2.3 ✓

🍎 macOS(Apple 芯片 M 系列)

  1. 在 "Assets" 区域下载 HyperOnlineVideo-1.2.3-arm64.dmg
  2. 双击打开 → 把「聚合视频」拖进 应用程序 文件夹
  3. 第一次打开会被 macOS 拦下(未付费公证的应用都会这样 ✓ 正常现象):
    • 方法 A:右键点图标 → 选「打开」→ 再点一次「打开」
    • 方法 B(推荐):打开「终端」粘贴:
      sudo xattr -dr com.apple.quarantine /Applications/HyperOnlineVideo.app

🐧 Linux —— 按你的发行版选一条(全部为软件源安装 ✓)

Arch Linux / Manjaro / EndeavourOS

# ① 还没装 AUR 助手的话先装 yay(已有 yay/paru 就跳过)
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git /tmp/yay && cd /tmp/yay && makepkg -si

# ② 安装(首次自动编译约 2-3 分钟)
yay -S hov-qt

Fedora 44 / 45

sudo dnf copr enable houge/hov-qt
sudo dnf install hov-qt

openSUSE Tumbleweed

sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Tumbleweed/ obs-houge
sudo zypper install hov-qt

openSUSE Leap 16.0

sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Leap_16.0/ obs-houge-leap
sudo zypper install hov-qt

NixOS(声明式 · flake)

在 /etc/nixos/flake.nix 的 inputs 里加:

hov-qt = {
  url = "github:HougeLangley/HyperOnlineVideo";
  inputs.nixpkgs.follows = "nixpkgs";
};

在 configuration.nix(或 home-manager 的 home.nix)里加:

environment.systemPackages = [ inputs.hov-qt.packages.x86_64-linux.default ];

然后重建:

sudo nixos-rebuild switch

首次编译约 5 分钟 ✓ WebEngine 登录窗在 NixOS 下默认不链接(登录请手动放置 cookie 文件,与应用内说明一致 ✓)


二、本版亮点(v1.2.3 更新内容)

📺 B 站搜索升级:wbi 签名(三端)

  • B 站已对旧版搜索接口的风控收紧(冷请求会被拦截);本版三端统一升级为官方现行 wbi 签名协议:
    • nav 获取密钥 → mixin 表生成签名 → w_rid = md5(query + mixin),密钥缓存 6 小时(自动跟进每日轮换 ✓)
    • 策略:wbi 优先,失败自动回退旧接口 ✓(双保险,用户无感 ✓)
  • 实测:三端均返回 20 条搜索结果 ✓(Android 真机 / Linux 装机版 / macOS ✓)

📱 Android:播完自动连播加固

  • 修复"某些环境播完不切下一首"的边界:mpv 结束后 time-pos/duration 会被卸载,
    个别环境结束标志不翻转 → 新增稳健兜底判据(曾正常播放过 + 双属性失效 = 已结束 ✓)
  • 新增诊断日志(播放结束/切歌/守卫值 ✓)——同类问题一行定位 ✓
  • 说明:若您此前关闭过「设置 → 播放 → 播完自动连播(队列)」,播放器播完会按设计退出 ✓ 请确认该开关为开启状态 ✓

🔧 维护核查

  • yt-dlp:三端均为最新稳定版 2026.08.19 ✓(Android 启动自更新 ✓ / macOS 跟随 Homebrew ✓ / Linux 跟随发行版 ✓)
  • 四平台 API 审计:YouTube(yt-dlp ✓)/ 网易云 / QQ 音乐 均为现行最优协议 ✓ 无需变更 ✓

三、完整更新日志(自 v1.2.2 起)

  • B站:搜索升级 wbi 签名(三端同款 · 旧接口自动回退 · 密钥 6h 缓存)
  • Android:播完自动连播稳健兜底 + 三处诊断日志
  • 维护:yt-dlp 版本核查(2026.08.19 = 最新稳定 ✓);四平台 API 审计与存档
  • 工程:B站搜索解析逻辑三端抽公共函数(去重);文档补充(踩坑 #289/#290)

四、已知问题与说明

  • B站登录:部分功能(1080P+/字幕等)需登录;升级后若搜索异常,请在应用内重新登录 B 站 ✓
  • Apple 公证:macOS 应用未做付费公证,首次打开需按第一节方法绕过(正常现象 ✓)
  • QQ 音乐:若提示"需重新登录",在应用内「登录」页重新登录即可 ✓

五、致谢

感谢真实使用场景中的每一条反馈 —— 本版的 B站 wbi 升级与 Android 连播加固均源于日常使用观察 ✓
发现问题欢迎开 Issue ✓

聚合视频 v1.2.2 —— 音乐体验大版本(QQ 真翻页 / 封面 / 字幕 / 画质 / 稳定性)

Choose a tag to compare

@HougeLangley HougeLangley released this 25 Sep 15:09

聚合视频 v1.2.2 —— 音乐体验大版本(Android / macOS / Linux 全平台 · 全发行版)

本次更新聚焦音乐体验与稳定性:QQ 音乐搜索实现真·无限下滑翻页(Desktop 协议,20 首/页);
网易云与 QQ 的翻页封面、下载内嵌封面全面修复;新增 CDN 节点择优与 mpv 日志泵,
根治"随机不播";字幕自动选轨、画质上限、长歌词自适应三端对齐;macOS 若干崩溃修复。

Linux 端同样不提供打包文件下载 —— 全部通过官方软件源安装(一键命令、自动更新 ✓),第一节即为完整安装指南。


一、下载与安装(小白也能看懂 · 复制粘贴即可)

📱 Android(手机 / 平板)

  1. 在本页下方 "Assets" 区域点击 app-release-1.2.2.apk 下载
  2. 在手机上打开该文件;若提示「禁止安装未知应用」,按提示允许(安卓装非商店应用的标准流程 ✓)
  3. 安装完成后,桌面出现「聚合视频」图标即成功 ✓

要求 Android 15(API 35)及以上 ✓ 应用内「设置 → 关于」可确认版本为 1.2.2 ✓

🍎 macOS(Apple 芯片 M 系列)

  1. 在 "Assets" 区域下载 HyperOnlineVideo-1.2.2-arm64.dmg
  2. 双击打开 → 把「聚合视频」拖进 应用程序 文件夹
  3. 第一次打开会被 macOS 拦下(未付费公证的应用都会这样 ✓ 正常现象):
    • 方法 A:右键点图标 → 选「打开」→ 再点一次「打开」
    • 方法 B(推荐):打开「终端」粘贴:
      sudo xattr -dr com.apple.quarantine /Applications/HyperOnlineVideo.app

🐧 Linux —— 按你的发行版选一条(全部为软件源安装 ✓)

Arch Linux / Manjaro / EndeavourOS

# ① 还没装 AUR 助手的话先装 yay(已有 yay/paru 就跳过)
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git /tmp/yay && cd /tmp/yay && makepkg -si

# ② 安装(首次自动编译约 2-3 分钟)
yay -S hov-qt

Fedora 44 / 45

sudo dnf copr enable houge/hov-qt
sudo dnf install hov-qt

openSUSE Tumbleweed

sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Tumbleweed/ obs-houge
sudo zypper install hov-qt

openSUSE Leap 16.0

sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Leap_16.0/ obs-houge-leap
sudo zypper install hov-qt

NixOS(声明式 · flake)

在 /etc/nixos/flake.nix 的 inputs 里加:

hov-qt = {
  url = "github:HougeLangley/HyperOnlineVideo";
  inputs.nixpkgs.follows = "nixpkgs";
};

在 configuration.nix(或 home-manager 的 home.nix)里加:

environment.systemPackages = [ inputs.hov-qt.packages.x86_64-linux.default ];

然后重建:

sudo nixos-rebuild switch

首次编译约 5 分钟 ✓ WebEngine 登录窗在 NixOS 下默认不链接(登录请手动放置 cookie 文件,与应用内说明一致 ✓)


二、本版亮点(v1.2.2 更新内容)

🎵 音乐 —— QQ 真·无限下滑翻页

  • QQ 音乐搜索现在支持真·无限下滑翻页(每页 20 首,滑到底自动加载下一页并无限延续 ✓)
    • 采用 QQ 现行 Desktop 搜索协议(DoSearchForQQMusicDesktop + 数字型分页参数),
      匿名可用、登录后更稳;三端(Android / macOS / Linux)同款实现 ✓
  • 翻页封面修复:搜索结果滑到后面不再"灰块" —— 修复了"同专辑多曲只显示第一张封面"的缩略图缓存缺陷 ✓
  • 下载内嵌封面:下载的音乐现在会把专辑封面写进文件标签(mp3 的 attached_pic),
    文件管理器 / 播放器都能看到封面 ✓(ffprobe 实测验证 ✓)

🎧 音乐 —— "随机不播"根因修复

  • 网易云 CDN 节点择优:网易云返回的流地址会随机落在 m701~m804 等节点,个别节点会 403;
    现在会自动探测并选择可用节点(失败自动回退),根治"点了没声音、进度条不动" ✓
  • mpv 日志泵:新增播放器事件/日志通道(此前播放器错误被静默吞掉),排障能力大幅提升 ✓
  • 登录态降级链:请求失败自动尝试备用通道;QQ 登录态过期时会明确提示重新登录(不再静默 0 条 ✓)

💬 字幕 —— 自动选轨修复(三端)

  • 修复"AI 字幕被标成(自动翻译)导致评分错位、字幕不自动选"的问题;新增裸「中文 / Chinese」兜底匹配 ✓
  • B 站字幕改走直连 + 429 退避重试,VPN 环境下不再间歇性拉不到字幕 ✓

🎬 画质 —— "视频清晰度上限"设置真正生效

  • 修复"设置了 1080p 但实际仍按默认档位播放"的问题(加载顺序 + UI 回填);Linux/Android 补齐设置项 ✓

✍️ 歌词 —— 长句自适应(三端)

  • 长歌词不再溢出播放窗口:总高超出时自动逐档缩小字号(下限 0.55×)✓
  • macOS 修复"音乐模式背景变黑、歌词变成视频字幕样式"的问题 ✓

🛡️ 稳定性 / 其他

  • macOS:修复搜索后崩溃(共享缓存改为主线程单一写入口 ✓)
  • macOS:修复关闭登录窗崩溃(WebEngine 析构竞态 ✓)
  • Linux:修复虚拟机环境登录窗"桌面穿透"(GL 兼容 ✓)
  • 播放器:修复"上一曲播完点下一首停在 0:00"的竞态 ✓
  • 音乐模式:封面 + 玻璃背景 + 滚动歌词 + 逐字高亮全面对齐三端 ✓

三、完整更新日志(自 v1.2.1 起)

音乐

  • QQ 搜索换用现行接口并支持真分页无限下滑(三端)
  • 网易云 / QQ 翻页封面预热与回填修复
  • 下载音乐内嵌封面(Linux / macOS / Android 三端)
  • 网易云 CDN 节点择优(403 节点自动规避)
  • mpv 事件/日志泵(播放失败不再静默)
  • 登录态失效自动降级 + 明确提示
  • 音乐模式:封面/玻璃背景/滚动歌词/逐字高亮对齐(Linux 修复歌词滚动 ✓)
  • 音质上限(无损/320k/128k)三端对齐;左下角"音质档位"分流 ✓

字幕 / 歌词

  • 自动选轨:AI 字幕误标修复 + 裸中文兜底 + B 站直连退避(三端)
  • 长歌词自适应缩字(三端);macOS 音乐模式歌词修复
  • 本地 sidecar 歌词(.lrc)显示与滚动修复

视频 / 画质

  • 清晰度上限设置修复(Linux / macOS / Android 三端生效)
  • 视频清晰度 UI 回填与切换修复

稳定性

  • macOS:搜索崩溃、登录窗崩溃、音乐模式黑屏修复
  • Linux:虚拟机 GL 登录窗穿透修复、关窗崩溃修复、播放器竞态修复
  • Android:多 buffer 日志、输入法兼容等工程改进

打包 / 工程

  • Linux 全渠道:Arch(pkgrel=12)· Ubuntu deb · Fedora rpm(Copr)· openSUSE(OBS)· AppImage · NixOS flake
  • 三端代码审计清理(重复代码消除、缩进规范化)
  • 文档:踩坑百科(#270-#288)、构建矩阵更新

四、已知问题与说明

  • QQ 音乐搜索:接口侧当前对无效登录态/匿名访问有风控(返回 code=2001)。应用已内置降级与提示;
    若提示"需重新登录",请在应用内「登录」页重新登录 QQ 音乐即可恢复(搜索结果与翻页均不受影响 ✓)。
  • Apple 公证:macOS 应用未做付费公证,首次打开需按第一节方法绕过(正常现象 ✓)。
  • NixOS:WebEngine 登录窗默认不链接;登录请按应用内说明手动放置 cookie 文件 ✓。

五、致谢

感谢所有测试与反馈的朋友 —— 1.2.2 的"QQ 无限下滑翻页"与"随机不播"根治均来自真实使用场景的反馈 ✓
发现问题欢迎开 Issue ✓

聚合视频 v1.2.1 —— 全平台正式发布(Android / macOS / Linux 全发行版)

Choose a tag to compare

@HougeLangley HougeLangley released this 24 Sep 09:51

聚合视频 v1.2.1 —— 全平台正式发布(Android / macOS / Linux 全发行版)

本次是首次全平台发布:Android、macOS、以及 Linux 的 Arch / Fedora / openSUSE / NixOS 全渠道同步上线 ✓
Linux 端不提供打包文件下载 —— 全部通过官方软件源安装(一键命令、自动更新 ✓),本文第一节即为完整安装指南。


一、下载与安装(小白也能看懂 · 复制粘贴即可)

📱 Android(手机 / 平板)

  1. 在本页下方 "Assets" 区域点击 app-release-1.2.1.apk 下载
  2. 在手机上打开该文件;若提示「禁止安装未知应用」,按提示允许(安卓装非商店应用的标准流程 ✓)
  3. 安装完成后,桌面出现「聚合视频」图标即成功 ✓

要求 Android 15(API 35)及以上 ✓ 应用内「设置 → 关于」可确认版本为 1.2.1 ✓

🍎 macOS(Apple 芯片 M 系列)

  1. 在 "Assets" 区域下载 HyperOnlineVideo-1.2.1-arm64.dmg
  2. 双击打开 → 把「聚合视频」拖进 应用程序 文件夹
  3. 第一次打开会被 macOS 拦下(未付费公证的应用都会这样 ✓ 正常现象):
    • 方法 A:右键点图标 → 选「打开」→ 再点一次「打开」
    • 方法 B(推荐):打开「终端」粘贴:
      sudo xattr -dr com.apple.quarantine /Applications/HyperOnlineVideo.app

🐧 Linux —— 按你的发行版选一条(全部为软件源安装 ✓)

Arch Linux / Manjaro / EndeavourOS

# ① 还没装 AUR 助手的话先装 yay(已有 yay/paru 就跳过)
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git /tmp/yay && cd /tmp/yay && makepkg -si

# ② 安装(首次自动编译约 2-3 分钟)
yay -S hov-qt

Fedora 44 / 45

sudo dnf copr enable houge/hov-qt
sudo dnf install hov-qt

openSUSE Tumbleweed

sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Tumbleweed/ obs-houge
sudo zypper install hov-qt

openSUSE Leap 16.0

sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Leap_16.0/ obs-houge-leap
sudo zypper install hov-qt

NixOS(声明式 · flake)

在 /etc/nixos/flake.nix 的 inputs 里加:

hov-qt = {
  url = "github:HougeLangley/HyperOnlineVideo";
  inputs.nixpkgs.follows = "nixpkgs";
};

在 configuration.nix(或 home-manager 的 home.nix)里加:

environment.systemPackages = [ inputs.hov-qt.packages.x86_64-linux.default ];

然后重建:

sudo nixos-rebuild switch

只想先试试:nix run github:HougeLangley/HyperOnlineVideo ✓

Ubuntu / Debian / 其它发行版(源码构建 · 约 5 分钟)

sudo apt update
sudo apt install -y git cmake ninja-build pkgconf \
  qt6-base-dev qt6-declarative-dev qt6-webengine-dev \
  libmpv-dev mpv ffmpeg yt-dlp

git clone https://github.com/HougeLangley/HyperOnlineVideo.git
cd HyperOnlineVideo/desktop
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DHOV_WEBENGINE=ON
cmake --build build
./build/hov-qt

安装到系统(带桌面图标):sudo cmake --install build --prefix /usr/local ✓


二、本版亮点

三端下载面板与下载能力(本版主题)

  • Linux(Qt6):新增下载面板(进度条 / 重试失败 / 逐条取消 / 取消全部 / 打开下载目录 / LRU 清理)与收藏面板;
    视频下载修复(起播时记录直链、扩展名与 macOS 对齐);「清理」现在会真正把已结束条目从列表移除。
  • macOS:新增 DownloadsPanel(字节级进度、取消全部、重试失败)、面板可拖拽缩放(关闭按钮一键可用);
  • Android:下载卡片新增「取消」与「取消全部」;完成的卡片 3.5 秒自动淡出,不再堆积。

窗口与播放体验(Linux / macOS)

  • 窗口几何持久化:首启 1200×720 居中;退出时保存位置与大小(PiP/全屏态不污染记忆)。
  • 画中画(PiP)往返修复:进出 PiP 后左侧列表宽度、控制条不再错乱(两端同修)。
  • 长文本不再撑大窗口:状态栏/信息栏粘贴超长文本时的窗口跳变已修。
  • 视频独立窗口(macOS):从主窗弹出视频单独播放。
  • 字幕/歌词若干修复;main.cpp 拆分为多模块(MainWindow / Playback / PlayActions / SettingsDialog …),便于后续维护。

Linux 打包矩阵(v1.2.1 核心工程)

渠道 覆盖 状态
AUR(Arch) x86_64 / aarch64 / riscv64 ✅ 已发布(yay -S hov-qt)
Fedora Copr Fedora 44 / 45 × x86_64 / aarch64 / riscv64 ✅ 六个构建目标全过
openSUSE OBS Tumbleweed × 3 架构 + Leap 16.0 × 2 架构 ✅ 五目标全过
NixOS flake x86_64 / aarch64 ✅ 本机 rebuild 即用
Ubuntu / Debian deb 完整套件(本地构建) ✅ lintian 零告警

许可元数据全线统一为 GPL-3.0-only(与仓库 LICENSE 实际授予的版本一致)。


三、本次产物

平台 文件 大小
Android app-release-1.2.1.apk(R8 混淆) 70.8 MB
macOS HyperOnlineVideo-1.2.1-arm64.dmg 29.3 MB
Linux 无文件下载 —— 见上文各软件源(AUR / Copr / OBS / Nix flake) —

四、已知问题(如实)

问题 说明
YouTube 字幕偶发获取失败 YouTube 对部分 IP 的字幕接口限流(429),与应用无关;可稍后重试
B站部分接口 412 同上(IP 级限流)
QQ 音乐 VIP 曲目匿名不可取流 需登录(应用内登录窗口或导入 cookie)
Linux riscv64 无 App 内登录窗 Ubuntu riscv64 端口无 QtWebEngine 包 → 该架构自动降级为「手动放置 cookie」(与 AppImage 一致)
Ubuntu 暂无官方软件源 目前用源码构建(5 分钟,见上);后续如开通 OBS Ubuntu 目标会另行说明

五、升级说明

  • 三端配置文件共用(~/.config/hov/),覆盖升级不丢设置 / 队列 / 收藏 / 播放进度 / cookie ✓
  • Android:如果此前安装的是 debug 版,与发布版签名不同,需要先卸载再安装(正式版之间可直接覆盖升级 ✓)
  • Linux:AUR / Copr / OBS 用户直接 更新系统 即可(包管理器自动处理 ✓)

六、致谢与反馈

v1.2.0 —— Android 与 macOS 发布(Linux 延后至 v1.2.1)

Choose a tag to compare

@HougeLangley HougeLangley released this 21 Sep 14:33

聚合视频 v1.2.0 —— Android 与 macOS 发布(Linux 延后至 v1.2.1)

本次发布的正式产物只有两个平台:Android(APK)与 macOS(arm64 DMG)。


一、为什么本次只发 Android 与 macOS?(如实说明)

我们把"能跑"与"敢发布"分得很清楚,本版按后者执行:

平台 本次是否发布 原因
Android ✅ 发布 已通过真机完整验收:安装、启动、搜索、播放、下载、本地库、字幕、主题跟随。本版还修掉了一个真机可复现的崩溃(见下)。
macOS ✅ 发布 已通过本机多轮实测:SPM 构建、DMG 打包、播放、字幕、音频兜底、主题跟随全部走通。
Linux(Arch / Debian / Fedora) 🚧 本次不发布 打包链路已打通(Arch PKGBUILD、Debian dpkg-buildpackage、Fedora mock + Copr 均已实际出包),但:
① 三发行版之间功能与打包方式尚未统一;
② 若干优化(真实 GPU 下的渲染后端验证、长时续航等)尚未完成;
③ 按既定决策,Linux 端将统一实现、统一打包后随 v1.2.1 发布。
我们不愿意把一个"能编译但不保证各处一致"的 Linux 版本当作正式版推给用户。

Fedora 用户可在 Copr 测试渠道提前体验(sudo dnf copr enable houge/hov-qt),
但请务必理解为实验性、可能不稳定,正式支持见 v1.2.1。


二、本版亮点

一、崩溃与卡死根治(本版最重要)

  • Android:默认渲染后端导致的原生崩溃(本版核心修复) ★
    实测发现:mpv-android 的默认 vo=gpu 在部分机型(测试机 Xiaomi 17 Pro Max / Android 16)上
    在 vo 线程内原生崩溃(tombstone 栈在 libmpv.so,可 2/2 复现),
    而 vo=gpu-next(libplacebo)稳定可用(三轮复现 + PSNR 与 mpv 帧号双重佐证)。
    → 本版 Android 固定采用 gpu-next,设置项中不再提供开关(避免用户误选到会崩的路径);
    同时不读取历史设置,以免老版本遗留的 false 值把用户带回崩溃路径。
  • macOS:下载落盘卡主线程 1.9 秒 —— 文件删除/移动原先在主线程执行;
    改为放到 URLSession 回调(本就在后台队列),主线程只留状态更新。
  • 三端:退出时偶发 SEGV —— 数据源 model 信号原以 this 为接收者,析构顺序不定导致悬空调用;
    改为以被访问对象为接收者(Qt 侧:谁被槽访问,谁当接收者)。
  • Linux(本版未发布,一并说明):中文环境启动段错误(libmpv 要求 LC_NUMERIC=C,且校验发生在
    动态库加载阶段)→ 由启动器脚本在 exec 前修正;长时间播放后 abort(libmpv 的 GL fence 泄漏)
    → 在 get_proc_address 处包装 glFenceSync/glDeleteSync 记账兜底。

二、主题跟随系统(新增)

  • 三端统一设置项 ui.theme = auto | dark | light(默认 auto);
  • Android:isSystemInDarkTheme() + Compose 状态桥,切换即时生效;
  • macOS:ThemeController 单点真相(darkAqua / aqua 实测确认);
  • Linux 走 XDG Desktop Portal(本版未发布)。

三、字幕

  • 默认显示改为"按系统语言自动选轨":按系统语言提示给字幕轨打分(精确匹配 > 同语族 > 中文简繁 > 英文兜底),
    只有匹配到才自动开启 —— 而不是无脑打开第一条;
  • 字幕字号统一为画面高度的 2.8%(下限 13px),三端一致;
  • macOS 侧修复了三处各自写 karaoke 标记导致的顺序 bug(收敛为单一写入口)。

四、音频可靠性(macOS)

  • 纯音频兜底:当选中档位只有视频流(acodec==none)时,自动改用 bestAudioOnlyUrl;
  • 音轨看门狗:10 秒无音轨提示、15 秒无音频数据则自动换轨;
  • 全部字段写入 [AUDIO] 日志,便于排查。

五、搜索与界面

  • 搜索结果无限下拉:每页 20 条、无开关、页数上限 YouTube 6 页 / 其它 5 页、
    按"多取后截尾"翻页、URL 去重、会话代次防竞态;滚动到距底 200px 自动加载;
  • 卡片视图:完整缩略图(fit,不裁切)+ 标题两行 + 来源标签,真·masonry 排布;
  • 状态信息不再污染结果区(独立状态行);
  • 结果区尺寸启动固定为「横向 2 张 × 纵向 4 张」,拖动分隔条后记住。

六、播放可靠性(三端)

  • 直链过期自愈:记录解析时刻 + 按来源 TTL(YouTube 4h / B站 2h / 音乐 30min),
    过期或进度停滞 15 秒时自动重新解析并回到原位置(每条内容最多自愈一次);
  • 后台属性快照:主线程读 mpv 属性会拿核心锁,网络 demux 期间易冻结 →
    改为后台线程 5Hz 快照,GUI 只读快照;
  • 缓存按来源区分:网络 cache=yes / 60s / 64MiB;本地 cache=no / 4s / 8MiB(本地大缓存会导致拖动冻结)。

七、下载

  • 视频不再"没有声音":bv*+ba 拆成两路时原先只下第一路 →
    现为视频下完后并行下载音轨(带 Referer/UA)→ ffmpeg 本地混流(-c copy)→ 清理临时文件;
  • 音乐下载带封面 + .lrc 侧车;视频任务一律跳过音乐标签嵌入;B站/YouTube 下载补 Referer。

三、本次产物

平台 文件 说明
Android app-release-1.2.0.apk 含 gpu-next 固定渲染后端(崩溃修复)、主题跟随、字幕按系统语言
macOS HyperOnlineVideo-1.2.0-arm64.dmg Apple Silicon;含主题跟随、字幕/音频修复、落盘 I/O 修复

校验和见随发布附带的 SHA256SUMS-1.2.0.txt(也可在 Release 附件中核对)。

Linux 产物不在本次发布内。若你是 Linux 用户,可以:

  • 现在就从源码构建(README.md 已提供 Arch / Debian / Fedora 三套可照做的完整步骤);
  • 或试用 Fedora Copr 测试渠道(实验性,当前不稳定);
  • 或等待 v1.2.1 —— 我们会把三发行版的功能与打包统一后一起发布。

四、已知问题(如实)

  1. Linux 端:功能与打包仍在统一中,本版不发布;Copr 渠道为实验性、可能不稳定。
  2. Linux 侧三处文件 I/O 仍在主线程(LRU 清理、混流替换、入队删旧文件),与 macOS 同类问题;
    Linux 上未观测到卡顿,已记录待改,随 v1.2.1 处理。
  3. Linux Flatpak / AppImage 暂缓(AppImage 打包链路在安装布局变更后需修复)。
  4. 非致命日志问题:直链自愈在"直链来自上次会话恢复"时会打印一个无意义的极大秒数
    (内部把绝对时间戳当成了已过时长)。仅影响日志可读性,不影响自愈行为,计划在 v1.2.1 修正。
  5. YouTube 字幕 429 / 机房 IP 风控属网络环境问题,非应用缺陷;VM 内 B 站 412 同理。
  6. macOS 应用未做公证(notarization),首次运行需在「隐私与安全性」中手动允许。

五、升级说明

  • 三端共用配置:~/.config/hov/settings.json、queue.json、播放进度与本地库均为覆盖安装不丢数据;
  • Android:从 v1.1.0 升级直接安装覆盖即可;若此前装的是 debug 版再装 release 版会因签名不同失败,
    需先卸载(debug 与 release 签名不可混装,这是 Android 的机制,不是应用缺陷);
  • macOS:首次运行如被拦截,见「系统设置 → 隐私与安全性 → 仍要打开」。

六、致谢与反馈

聚合视频 v1.1.0

Choose a tag to compare

@HougeLangley HougeLangley released this 21 Sep 14:33

聚合视频 v1.1.0 —— 三端统一发布

Android · Linux(Qt6/Wayland) · macOS(AppKit) —— 同一套配置文件、同一套快捷键、同一套自检。

本版亮点

三端都有的核心能力

  • 在线播放零广告:YouTube / B站 解析直链后交给 libmpv,App 层不插播、不裁剪
  • 音乐:网易云音乐 + QQ音乐 搜索、播放、歌词(含逐字高亮)、封面、下载
  • 在线字幕:B站 CC(官方 API)与 YouTube 字幕(yt-dlp),App 层统一渲染
  • 本地库:下载目录浏览、排序、重命名、直接播放
  • 播放队列:顺序 / 单曲 / 随机 + 持久化(跨端共用 queue.json)
  • 进度记忆:自动续播(≥15 秒且未接近结尾才续播)
  • 收藏:跨端共用 favorites.json
  • App 内登录:内置浏览器登录,cookie 自动落盘为 Netscape 格式(yt-dlp 可直接复用)
  • 媒体控制:Android MediaSession(通知栏/锁屏)、Linux MPRIS(媒体键/playerctl)、macOS 控制中心/键盘媒体键

各端要点

本版新增
Android 版本号 1.1.0(versionCode 2);与 v1.0.0 功能一致,含此前全部能力
Linux 进度记忆 / MPRIS 媒体键 / 在线字幕(B站官方 CC API)/ 音乐封面与播放中切音质 / 下载 LRU 清理 / 本地库
macOS 首次发布:完整界面(搜索·播放·队列·歌词字幕·本地库·设置·收藏)、媒体键、WKWebView 登录、自包含 .app + DMG

产物

平台 文件 大小
Android app-release.apk(已签名,versionName 1.1.0) 72.6 MB
Linux HyperOnlineVideo-aarch64.AppImage 88.7 MB
Linux hov-qt-1.1.0-1-aarch64.pkg.tar.xz(Arch) 497 KB
Linux HyperOnlineVideo.flatpak 40.5 MB
macOS HyperOnlineVideo-1.1.0-arm64.dmg(自包含,含 48 个动态库) 29 MB

安装提示

  • Android:安装 APK 需允许"未知来源";首次使用建议在 App 内登录(YouTube/B站/网易云/QQ音乐)
  • Linux:AppImage 需 chmod +x;Arch 包用 pacman -U;Flatpak 用 flatpak install <文件>
    • AppImage / Flatpak 不含 QtWebEngine(体积考虑),登录请把 cookie 放到 ~/.config/hov/cookies/
    • 需要系统提供 yt-dlp(pacman -S yt-dlp / apt install yt-dlp)
  • macOS:App 未做 Apple 公证,首次打开若提示"无法验证开发者",请右键 → 打开,或执行
    xattr -dr com.apple.quarantine /Applications/HyperOnlineVideo.app
    • App 自带 libmpv/ffmpeg,无需额外安装;在线解析仍需 brew install yt-dlp

已知限制(如实说明)

  • 三端均不绕过版权与平台规则:VIP/版权受限曲目在未登录(或非会员)时无法播放,会明确提示并自动跳到下一首
  • B站 CC 字幕覆盖率取决于视频本身;YouTube 字幕在部分网络环境下会受限流影响
  • 直播、番剧、付费课程等未做专门适配
  • macOS 端暂无下载管理器;Android 的"仅 WiFi 下载"为移动端专属能力
  • 流量直连:Android 可在 App 内彻底绕过 VPN;桌面端仅能绕过"环境变量代理"(TUN 类代理需在代理工具里配规则)

自检结果(发布前跑通)

平台 项目 结果
Android 单元测试 16 / 16 通过
Linux --queue-selftest 52 / 52 通过
macOS --selftest-logic 41 / 41 通过

许可

GPL-3.0-or-later。本项目仅用于个人学习与研究,请遵守各内容平台的用户协议。