UnBox

项目概述

UnBox 是一款面向电视盒子与 IPTV 用户的跨平台桌面播放器，把直播与点播收进同一套界面。它支持 TVBox 单线路源、FongMi 多线路源以及 M3U / TXT 直播源，还带本地媒体库与断点续播。下载对应平台的安装包即可使用，无需部署服务，也无需配置 Go / Node 环境。

装上就能看，直播与点播一个安装包搞定。

主要功能

• 直播加点播：一套界面同时支持 IPTV 直播与视频点播，分类、分组与搜索齐全
• 多源导入：支持 TVBox 单线路源、FongMi 多线路源与 M3U / TXT 直播源
• 本地媒体库：添加本地目录并递归扫描视频，支持海报展示与断点续播
• 智能播放路由：H.264 走内置 Web 播放器，HEVC / RTMP / MKV 等自动切换到外部 mpv
• 播放设置：可开启自动切集、自动换源与下一集预载
• 全站搜索：并发搜索所有已导入站点，结果实时刷新且可随时中断
• 源管理：点播源与直播源独立导入，保留历史配置，一键切换
• 日志与更新：内置日志弹窗，设置页可一键检查新版本

适用人群

• 用电脑看电视盒子或 IPTV 的用户
• 需要本地媒体库与断点续播的用户
• 想统一管理多个点播源的用户

快速上手

1. 前往 Releases 下载对应平台的安装包并安装
2. 打开「设置」页，粘贴导入点播源（TVBox 单线路 / FongMi 多线路 JSON 地址）或直播源（M3U / TXT）
3. 在「点播」页选择线路与站点，浏览分类或全站搜索，进入详情页选集播放
4. 在「直播」页选择分组与频道后点击播放
5. 在「媒体库」页添加本地目录并点「重新扫描」，即可浏览播放本地视频

核心优势

• 无需环境：运行时无需安装 Go / Node，前端资源已编译进二进制
• 播放灵活：根据格式在内置 Web 播放与 mpv 之间智能路由
• 跨平台：Windows、macOS 与 Linux 均有安装包
• 源兼容广：单线路、多线路与直播源都能导入

系统要求

平台	架构	最低版本
Windows	amd64 / arm64	Windows 10 1809 及以上
macOS	amd64 + arm64	macOS 12 Monterey 及以上
Linux	amd64	Ubuntu 24.04+ / Debian 13+

注意事项

• HEVC / RTMP 与 MKV、AVI 等本地容器需要 mpv，macOS 与 Linux AppImage 需自行安装
• Linux 使用 AppImage 时不会自动安装系统依赖，缺失时需手动补装 GStreamer 组件
• 基于 csp_ JAR 与 xpath（type=0）的站点暂不支持