Tunarr：用自有媒体搭建直播电视频道

项目简介

Tunarr 是一个自托管的直播电视频道搭建工具。它可以把你在 Plex、Jellyfin、Emby 中的媒体库，或本地文件里的电影、剧集、音乐视频，编排成一条条“像真实电视台一样”的直播频道，并对外提供流媒体播放。

观看方式有两种：把 Tunarr 伪装成 HDHomeRun 调谐器接入 Plex、Jellyfin、Emby，或者取用它的 M3U 地址，喂给 Tivimate、UHF 等任意 IPTV 播放器。

主要功能

媒体源

• 连接 Plex、Jellyfin、Emby 或本地文件库
• 跨所有已连接媒体库进行高级搜索、筛选与排序

频道管理

• 拖拽式编排编辑器
• 节目之间可插入填充内容（广告、音乐视频、片头、台标等）
• 每个频道可单独设置台标，并自动备份配置

排期

• 时间槽与随机槽排期工具
• 基于网页的电视节目单，用于查看各频道编排

播放与集成

• 伪装 HDHR 调谐器，供 Plex、Jellyfin、Emby 使用
• 输出 M3U/IPTV，可接入 Dispatcharr、Threadfin、xTeVe 或任意 IPTV 客户端
• 直接在浏览器中播放频道
• 按频道设置音频语言与字幕偏好

转码

• 硬件加速转码：Nvidia NVENC、VAAPI、Intel QuickSync、macOS VideoToolbox
• 多套转码配置，可按频道分别指定

安装与使用

最简单的方式是用 Docker Compose。新建 docker-compose.yml：

services:
  tunarr:
    image: chrisbenincasa/tunarr:latest
    container_name: tunarr
    ports:
      - 8000:8000
    environment:
      - TZ=America/New_York
    volumes:
      - ./tunarr-data:/config/tunarr
    restart: unless-stopped

然后运行：

docker compose up -d

启动后访问 http://localhost:8000 即可使用。

其他安装方式：

硬件加速转码的配置方式见转码文档。

开发环境：

pnpm i
pnpm turbo dev  # backend at :8000, frontend at :5173/web

注意事项

• 从 2026.10.4 版本开始，时间槽与随机槽排期中不再接受 movie 类型的槽位，请改用 custom-show 槽位来编排电影。
• 数据与配置默认保存在容器内的 /config/tunarr，请通过挂载卷持久化。
• 硬件加速转码需要宿主机的显卡与驱动支持，具体配置请参考官方转码文档。
• 完整的安装、建频道、排期与转码说明见官方文档。
• 项目采用 Zlib 许可证。

本作品整理自 GitHub 开源项目 chrisbenincasa/tunarr，原作者 @chrisbenincasa，许可证 Zlib。中文介绍由 AI 根据项目 README 整理，以原仓库为准。