FreeBox

FreeBox

---

快速开始 | 播放失败、使用问题等看这里 | Spider编写

一个基于 JavaFX 开发的影视播放软件

## 一、介绍 FreeBox是一款集成了**影视播放**和**资源审计**功能的桌面端软件，具有如下特点： - 简约：作者的开发原则是“非必要不引入”，严格控制软件体积； - 易用：延续经典TVBox风味，配置简单直观； - 更新方便：作者将持续维护、发版，且软件的安装版支持自更新； - ~~开箱即用~~：前提是你安装一个[受支持的播放器](https://github.com/kknifer7/FreeBox/wiki/%E6%92%AD%E6%94%BE%E5%99%A8%E7%9A%84%E9%80%89%E6%8B%A9%E5%92%8C%E6%94%AF%E6%8C%81%E6%83%85%E5%86%B5)； - 主流三端+双架构支持，提供AppImage，可以照顾到多数Linux发行版； - 开发者友好：具备资源审计、Spider脚本的 [热更新调试](https://github.com/kknifer7/CatVodSpider-PC/wiki/JS-Spider%E7%BC%96%E5%86%99#%E4%BA%94%E7%83%AD%E6%9B%B4%E6%96%B0%E8%B0%83%E8%AF%95) 功能，无需自行搭建环境就能实现Spider开发。 [查看软件功能列表](https://github.com/kknifer7/FreeBox/tree/main?tab=readme-ov-file#%E5%9B%9B%E5%8A%9F%E8%83%BD%E5%88%97%E8%A1%A8--%E5%BC%80%E5%8F%91%E8%AE%A1%E5%88%92) **本软件完全免费、开源，如果您下载或使用了本软件，视为您已阅读并同意本软件的[许可协议](https://sourceforge.net/p/freeboxk/main/ci/main/tree/src/main/resources/io/knifer/freebox/doc/license.txt?format=raw)，该许可协议也会在软件第一次打开时弹出** 软件基于猫影视规则，致力于TVBox生态的跨平台扩展。个人项目难免多有疏漏，欢迎讨论和PR，欢迎大家来玩~ --- ## 二、快速开始 前往B站查看介绍视频：[点击这里](https://www.bilibili.com/video/BV1AXgmzUENg/) ### 1. 下载 **推荐下载安装版而非zip、tar.gz这样的压缩包，安装版便于接收软件的自动更新** **建议在安装前阅读[安装指南](https://github.com/kknifer7/FreeBox/wiki/%E8%BD%AF%E4%BB%B6%E5%AE%89%E8%A3%85%E3%80%81%E5%8D%87%E7%BA%A7)** 前往 [Releases页面](https://github.com/kknifer7/FreeBox/releases) ，或者根据你的系统情况，参照下面的表格进行下载： | 操作系统 | 版本要求 | amd64 | arm64 | |:--------:|:--------:|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| | Windows | >=10 | [MSI安装包](https://gh-proxy.org/https://github.com/kknifer7/FreeBox/releases/latest/download/FreeBox_1.8.0.msi) \| [ZIP](https://gh-proxy.org/https://github.com/kknifer7/FreeBox/releases/latest/download/FreeBox_1.8.0_win.zip) | - | | macOS | >=11 | [DMG](https://gh-proxy.org/https://github.com/kknifer7/FreeBox/releases/latest/download/FreeBox_1.8.0_amd64.dmg) | [DMG](https://gh-proxy.org/https://github.com/kknifer7/FreeBox/releases/latest/download/FreeBox_1.8.0_arm64.dmg) | | Linux | - | [DEB](https://gh-proxy.org/https://github.com/kknifer7/FreeBox/releases/latest/download/FreeBox_1.8.0_amd64.deb) \| [RPM](https://gh-proxy.org/https://github.com/kknifer7/FreeBox/releases/latest/download/FreeBox_1.8.0_amd64.rpm) \| [AppImage](https://gh-proxy.org/https://github.com/kknifer7/FreeBox/releases/latest/download/FreeBox_1.8.0_amd64.AppImage) \| [tar.gz](https://gh-proxy.org/https://github.com/kknifer7/FreeBox/releases/latest/download/FreeBox_1.8.0_amd64.tar.gz) | [DEB](https://gh-proxy.org/https://github.com/kknifer7/FreeBox/releases/latest/download/FreeBox_1.8.0_arm64.deb) \| [RPM](https://gh-proxy.org/https://github.com/kknifer7/FreeBox/releases/latest/download/FreeBox_1.8.0_arm64.rpm) \| [AppImage](https://gh-proxy.org/https://github.com/kknifer7/FreeBox/releases/latest/download/FreeBox_1.8.0_arm64.AppImage) \| [tar.gz](https://gh-proxy.org/https://github.com/kknifer7/FreeBox/releases/latest/download/FreeBox_1.8.0_arm64.tar.gz) | ### 2. 影视-K下载 **如果您下载或使用了影视-K软件，视为您已阅读并同意影视-K软件的[免责声明](https://github.com/kknifer7/TV-K/raw/refs/heads/main/doc/%E5%85%8D%E8%B4%A3%E5%A3%B0%E6%98%8E.txt)** 影视-K项目地址 [GitHub - kknifer7/TV-K](https://github.com/kknifer7/TV-K) 影视-K下载 [蓝奏云 - 密码：7ej5](https://wwblv.lanzoul.com/b0139v1k7e) ### 3. 安装播放器 软件会自动检测你的电脑上是否安装了[受支持的播放器](https://github.com/kknifer7/FreeBox/wiki/%E6%92%AD%E6%94%BE%E5%99%A8%E7%9A%84%E9%80%89%E6%8B%A9%E5%92%8C%E6%94%AF%E6%8C%81%E6%83%85%E5%86%B5) ### 4. Spider项目 有能力有需要编写PC端爬虫的，可以参考：[kknifer7/CatVodSpider-PC](https://github.com/kknifer7/CatVodSpider-PC) --- ## 三、主要功能 ### 1. 播放源支持 软件目前支持**导入源**和**TVBox源**两种，其中： - 导入源：是指将接口链接直接配置进本软件，支持jar和js格式的Spider（type=3），其他类型的Spider后续将按需考虑支持。 - TVBox源：因PC与移动端设备存在环境差异，jar格式的源只支持安卓端。为了**缓解**PC端不能使用安卓端jar的问题，以及为实现后续更多的功能（如弹幕、放映厅、异地同步播放等），本软件可以与特定的 [影视-K](https://github.com/kknifer7/TV-K) 项目一起使用，实现把安卓端的资源投放到PC端来播放。 - 关于TVBox源的更多解释：总的来说，**目前阶段如果你希望在PC端播放安卓端的jar资源，本软件可以帮你省去在电脑上使用手机模拟器的过程（模拟器启动慢、性能差、对4k资源的支持有限），你只需要在同网络环境下的手机后台挂一个影视-K来连接本软件即可** - 作者正在考虑更换/改进此方案，欢迎到 [更好的安卓源兼容方案 · Issue #100](https://github.com/kknifer7/FreeBox/issues/100) 参与讨论。 #### 1.1 导入源 如下图操作： 导入的源会一直保存在软件中，无需重复导入 可将以下源地址作为测试使用： - https://pc.lushunming.qzz.io/json/config.json - 来自于 [lushunming/AndroidCatVodSpider](https://github.com/lushunming/AndroidCatVodSpider) ，是其他作者的项目，不由本人维护，仅作演示使用，感谢大佬的付出 #### 1.2 TVBox源 使用方式： 1. 在 影视-K App 右下角进入设置，再点击“FreeBox配对” 2. 在弹出的对话框中输入FreeBox主界面显示的本机IP和WebSocket服务的端口 **请仔细查看，相同颜色的框中的内容要一一对应** 3. 点击下面的“连接/重连”按钮，连接成功后 影视-K App 中会弹出提示，FreeBox也会收到通知 ### 2. 源审计 本功能面向的用户类型： - 源接口的维护者 - Spider的开发者 - 想知道一个源中哪些站点可用，哪些站点不可用，看一看请求数据的好奇用户 连接到源后，软件可以自动化审计源中的站点下的各个功能，获取请求和响应数据，以此判断站点是否可用，软件会筛选出不可用的站点，同时给出对应原因，以供用户来排查 使用方式： 1. 在首页源列表中单击选中你想审计的源 2. 点击列表下方的“播放源审计”，进入审计窗口 3. 左侧列表中会列出源中的所有站点，可以进行审计操作 - 批量审计：在左侧列表中勾选你想审计的站点，然后点击下方的“启动审计” - 单独审计：在左侧列表中单击你想审计的站点，然后点击中央窗口的“单独审计” 这里其他的东西可以自行摸索： ### 3. 软件设置 打开设置： 网络设置：一般无需更改，如果你知道自己在做什么，请随意 常规设置：可自行探索 ### 4. 影视点播 在首页的源列表中单击选中一个源后，点击“进入”即可进入影视点播界面，点击“断开”即可移除该源 影视点播界面的操作逻辑与tvbox完全一致 功能示意图： 对于TVBox源：播放记录、播放进度、收藏等数据，与手机app完全互通 对于导入源：上述的数据会独立保存，可以在设置中进行清理 ### 5. 其他说明 关于**自更新**：软件的安装版支持自更新，免安装版也可以使用自更新，但下载到的是安装包 --- ## 四、功能列表 & 开发计划 | **功能** | **优先级** | **备注** | 完成情况 | |:--------------------------------------------------:|:----------:|:-----------------------------------------------------------------------------------------------------------------------------------------------:|:--------:| | 影片离线缓存 | 高 | - | ❌️ | | 广告过滤 | 高 | 原创m3u8广告过滤算法，准确度高 | ✅ | | 直播源支持 | 高 | 支持 | ✅ | | 播放器字幕支持 | 高 | 支持在线搜索，支持多种字幕格式 | ✅ | | 播放器弹幕支持 | 高 | 支持导入ass格式弹幕 | ✅ | | 外部播放器支持 | 高 | 支持vlc和mpv播放器 | ✅ | | JS源支持 | 中 | 集成GraalJS，扩展性好 | ✅ | | 字体切换 | 中 | 支持一键切换界面字体 | ✅ | | 播放器空降 | 中 | 支持自定义空降，跳过影视片头、片尾 | ❌️ | | 更好的打包分发 | 中 | 支持主流三端、双架构 | ✅ | | 在线放映室 | 中 | 提供功能扩展，让软件连接到后端服务，实现**线上放映室**的功能（用户可以创建房间，分享影片，与线上的其他人同步观看，进行弹幕聊天等） | ❌️ | | 更多针对**影视源作者**和**Spider开发者**的功能支持 | 中 | 目前阶段，会优先完善“源审计”模块中的“自