kknifer7/FreeBox

项目介绍

FreeBox 是一个用 JavaFX 编写的桌面影视播放软件，沿用猫影视/TVBox 的规则格式，让习惯安卓 TVBox 的用户在 Windows、macOS 和 Linux 上获得类似的点播体验。它本身是「空壳播放器」，不内置任何片源，播放内容全部来自用户自行导入的源。

源分两类。导入源把接口链接直接配置进软件，支持 jar 和 js 格式的 Spider（type=3）。TVBox 源则可以配合同网络的安卓端影视-K 使用：手机后台挂着影视-K，把安卓端可用的 jar 源转投到电脑播放，播放记录、进度和收藏与手机端互通，省去在电脑上跑模拟器的麻烦。方案的背景和局限在 README 中有说明，作者也在 Issue #100 征集更好的安卓源兼容方案。

除播放外，软件提供源审计：选中一个源后，可以批量或单独审计源内各站点，抓取请求与响应，筛出不可用的站点并给出原因。这部分面向源接口维护者、Spider 开发者和想排查源问题的用户，而不是普通观影场景。

快速使用

1. 从 Releases 页面下载安装包，优先选安装版以便接收自更新；README 的下载表按系统和架构列出了 Windows 10+ 的 MSI、macOS 11+ 的 amd64/arm64 DMG，以及 Linux 的 DEB、RPM、AppImage 和 tar.gz（下载说明）。
2. 安装一个受支持的播放器，FreeBox 只做检测不内置播放器，可选范围见播放器支持说明。
3. 打开软件，在导入源界面粘贴接口地址。README 给出的演示地址 https://pc.lushunming.qzz.io/json/config.json 来自其他项目，仅作测试（导入操作）。导入的源会一直保存，无需重复导入。
4. 若要使用安卓端 jar 源，在同一网络下安装影视-K，进入设置点击「FreeBox配对」，填入主界面显示的本机 IP 和 WebSocket 端口，再点击「连接/重连」，两端会收到提示（配对步骤）。
5. 在源列表选中源后点「进入」开始点播；要审计则在选中源后点「播放源审计」，勾选站点批量审计，或单击单个站点做单独审计（审计操作）。

使用约束

• Windows 只提供 amd64 版本；macOS 和 Linux 同时提供 amd64 与 arm64 包。
• 从源码构建时，运行目标是 JDK 17+ 和 JavaFX 21.0.9（版本标识）；使用发布包则无需自行准备 Java 环境。
• 导入源目前只支持 jar 和 js 格式的 Spider（type=3），其他类型尚未覆盖；TVBox 源的 jar 只支持安卓端，桌面端需要影视-K 中转。
• 必须搭配 VLC 或 mpv 等外部播放器，软件本身不提供任何媒体内容。
• 项目采用 GPL-3.0，首次启动还会展示补充许可协议；协议声明用户需自行确保所配置第三方内容的合法性，软件定位为技术探索，不接受商业合作。

HotRepo 点评

在已记录的榜单数据中，FreeBox 只有 2026-11-03 的 Java 语言日榜一条记录：当日位列第 14 名，新增 25 Star，总 Star 2,118。它没有全部语言日榜名次，也没有 Star 曲线历史，因此这只是单日快照，不能用来判断走势。结合 Java/JavaFX 的实现和 CatVod 标签，它服务的是已经在 TVBox 生态内的桌面用户；源审计和 Spider 热更新调试让这部分用户有了替代模拟器的具体理由。