Skip to content

feat(preview): add Vivid Player to external players#579

Open
cjw1115 wants to merge 1 commit into
OpenListTeam:mainfrom
cjw1115:feat/add-vivid-player
Open

feat(preview): add Vivid Player to external players#579
cjw1115 wants to merge 1 commit into
OpenListTeam:mainfrom
cjw1115:feat/add-vivid-player

Conversation

@cjw1115

@cjw1115 cjw1115 commented Jul 5, 2026

Copy link
Copy Markdown

Summary / 摘要

Adds Vivid Player (Windows) to the video-preview external-player list, alongside PotPlayer / VLC / mpv / etc.

Vivid Player is a GPU-accelerated HDR video player for Windows (Dolby Vision, HDR10+, HDR Vivid, HLG, Dolby Atmos). It registers the vividplayer:// protocol and accepts an already-playable direct URL via its src=direct handoff, so OpenList's signed direct link maps straight onto it — no companion backend change needed:

vividplayer://play?src=direct&u=$edurl&title=$name
  • u uses $edurl (the encodeURIComponent'd direct link) so the link's own query string (&sign=...) survives intact inside the handoff URI.
  • title=$name is placed last so an unencoded filename cannot corrupt u (same convention as the existing Android / MX Player entries).
  • Gated to platforms: ["Windows"].
  • Adds public/images/vivid.webp (256×256) as the button icon.

为视频预览页的外部播放器列表新增 Vivid Player(Windows)。Vivid Player 是 Windows 上的 GPU 加速 HDR 播放器(Dolby Vision / HDR10+ / HDR Vivid / HLG / Dolby Atmos)。它注册了 vividplayer:// 协议并支持 src=direct 直链握手,OpenList 的签名直链可直接对接,无需后端配合。

  • This PR has breaking changes.
    / 此 PR 包含破坏性变更。
  • This PR changes public API, config, storage format, or migration behavior.
    / 此 PR 修改了公开 API、配置、存储格式或迁移行为。
  • This PR requires corresponding changes in related repositories.
    / 此 PR 需要关联仓库同步修改。

Related repository PRs / 关联仓库 PR:

  • OpenList:
  • OpenList-Docs:

Related Issues / 关联 Issue

N/A

Testing / 测试

  • go test ./... (N/A — frontend-only change)
  • Manual test / 手动测试:
    • pnpm install + pnpm dev (Node 24.18.0, pnpm 11.9.0); OpenList backend running on :5244 with a video storage.
    • Opened the video preview in a browser: the Vivid Player icon appears after PotPlayer with the correct tooltip.
    • Verified the generated href is vividplayer://play?src=direct&u=<encoded direct link>&title=<name>.
    • Clicking the icon launches Vivid Player and plays the file.

Checklist / 检查清单

  • I have read CONTRIBUTING.
    / 我已阅读 CONTRIBUTING
  • I confirm this contribution follows the repository license, contribution policy, and code of conduct.
    / 我确认此贡献符合仓库许可证、贡献规范和行为准则。
  • I have formatted the changed code with gofmt, go fmt, or prettier where applicable.
    / 我已按适用情况使用 gofmtgo fmtprettier 格式化变更代码。
  • I have requested review from relevant maintainers or code owners where applicable.
    / 我已在适用情况下请求相关维护者或代码所有者审查。

AI Disclosure / AI 使用声明

  • This PR includes AI-assisted content.
    / 此 PR 包含 AI 辅助内容。

Tools used / 使用工具:

  • ChatGPT
  • Codex
  • GitHub Copilot
  • Claude
  • Gemini
  • Other (please specify) / 其他(请注明):

Usage scope / 使用范围:

  • Code generation / 代码生成

  • Refactoring / 重构

  • Documentation / 文档

  • Tests / 测试

  • Translation / 翻译

  • Review assistance / 审查辅助

  • I have reviewed and validated all AI-assisted content included in this PR.
    / 我已审核并验证此 PR 中的所有 AI 辅助内容。

  • I have ensured that all AI-assisted commits include Co-Authored-By attribution.
    / 我已确保所有 AI 辅助提交都包含 Co-Authored-By 归属信息。

  • I can reproduce all AI-assisted content included in this PR without any AI tools.
    / 我可以在没有任何 AI 工具的情况下重现此 PR 中包含的所有 AI 辅助内容。

Add Vivid Player (Windows) to the video preview external-player list.
Vivid registers the `vividplayer://` protocol and accepts a direct,
already-playable URL via its `src=direct` handoff, so OpenList's signed
direct link maps straight onto it:

  vividplayer://play?src=direct&u=$edurl&title=$name

`u` uses `$edurl` (the encodeURIComponent'd direct link) so the link's
own query string survives intact inside the handoff URI; `title=$name`
is placed last so an unencoded filename can't corrupt `u`. Gated to
`platforms: ["Windows"]`.

Adds public/images/vivid.webp (256x256) as the button icon.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant