anonymoussystems/torbox-media-center

!https://raw.githubusercontent.com/TorBox-App/torbox-media-center/main/assets/header.png

📚 概述

TorBox Media Center允许您以简洁的方式轻松挂载TorBox媒体文件。它将可播放的媒体文件挂载到文件系统，供Jellyfin、Emby、Plex、Infuse、VLC或任何其他媒体播放器使用。通过TorBox的定制解决方案，您可以将文件挂载为虚拟文件（不占用存储空间）或.strm文件（任何大小的媒体库占用空间不到1GB）。

重要
TorBox不允许或纵容盗版行为。本工具仅用于您拥有合法权利的媒体文件。

✨ 核心功能

• 使用TorBox元数据搜索API自动组织媒体文件
• 简单安全地挂载媒体文件
• 确保媒体文件易于被媒体播放器发现
• 快速高效的性能
• 文件代理功能（适用于网络连接较慢的情况）
• 兼容所有系统和操作系统（使用strm挂载方式时）
• 媒体库大小无限制
• 自动更新媒体库和挂载内容

🤖 与Zurg的对比

• 与TorBox的可用性更好
• 免费提供最新功能
• 设置更快（无需配置）
• 不依赖RClone
• 针对TorBox优化
• 支持更多视频服务器/播放器
• 兼容种子、新闻组和网络下载

✖️ 本应用不具备的功能

• 文件夹自定义（仅限于"movies"和"series"）
• 提供WebDAV服务器（请使用TorBox的WebDAV功能）
• 支持所有类型文件（仅限于视频文件）
• 导致TorBox账户被封禁（由TorBox团队开发）
• "修复"或"更新"媒体库（违反TorBox服务条款）
• 添加新下载
• 自定义下载（更新/重命名）
• 管理下载（删除）

🔄 兼容性

💻 操作系统兼容性

使用fuse选项时，兼容性限于Linux/Unix/BSD系统，因为需要FUSE。https://macfuse.github.io/%E3%80%82

strm选项兼容所有系统。

如果选择fuse选项且系统不兼容，应用程序将报错并无法运行。

注意
如不确定，建议选择strm选项。

📺 播放器/媒体服务器兼容性

strm选项适用于支持.strm文件的媒体服务器，如Jellyfin和Emby。如果使用这两个播放器，建议使用strm挂载方式。

fuse选项适用于其他所有情况，如Plex、VLC、Infuse等。fuse方式将虚拟文件直接挂载到文件系统，如同本地文件，任何视频播放器都可流式播放，由TorBox Media Center处理后续操作。

提示
Emby / Jellyfin => strm
Plex / VLC / 其他 => fuse

🔌 选择挂载方式

https://github.com/TorBox-App/torbox-media-center/tree/main?tab=readme-ov-file#compatibility%E5%B7%B2%E8%A7%A3%E9%87%8A%E5%85%BC%E5%AE%B9%E6%80%A7%EF%BC%8C%E8%BF%99%E6%98%AF%E9%80%89%E6%8B%A9%E6%8C%82%E8%BD%BD%E6%96%B9%E5%BC%8F%E7%9A%84%E4%B8%BB%E8%A6%81%E4%BE%9D%E6%8D%AE%EF%BC%8C%E4%BD%86%E8%BF%98%E6%9C%89%E5%85%B6%E4%BB%96%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9%EF%BC%9A

1. fuse挂载方式创建的虚拟文件系统可能较慢（播放文件、读取文件、列出文件和目录），且占用更多资源，因为它模拟整个文件系统。此外，可能与https://github.com/TorBox-App/torbox-media-center/tree/main?tab=readme-ov-file#running-on-docker-recommended%E4%B8%8D%E5%85%BC%E5%AE%B9%EF%BC%88%E5%A6%82%E6%9E%9C%E4%BD%BF%E7%94%A8Docker%EF%BC%89%E3%80%82
2. strm挂载方式占用更多存储空间，且因是物理文本文件会产生磁盘读写。长期使用可能轻微损耗磁盘（影响不大，但需注意）。如果文件系统速度较慢（硬盘vs SSD），文件数量较多时可能更慢。

❓ 为何不使用RClone

我们希望减少使用本应用所需的组件数量。RClone仅用于FUSE挂载，但大多数Linux系统已预装某种FUSE，因此RClone是冗余的。RClone还会带来更多挑战，如配置、版本更新，且仍需FUSE。本应用不提供WebDAV API，因此实际上不需要RClone。

✅ 系统要求

1. TorBox账户，必须是付费计划。在此注册。
2. 运行Linux/Unix/BSD/https://macfuse.github.io/%E7%9A%84%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%88%96%E8%AE%A1%E7%AE%97%E6%9C%BA%EF%BC%8C%E5%BF%85%E9%A1%BB%E8%83%BD%E8%BF%90%E8%A1%8CPython%E6%88%96%E5%85%B7%E6%9C%89%E7%AE%A1%E7%90%86%E5%91%98%E6%9D%83%E9%99%90%EF%BC%88%E4%BB%85Docker%E5%AE%89%E8%A3%85%E9%9C%80%E8%A6%81%EF%BC%89%E3%80%82
3. 确定要使用的播放器（用于选择挂载方式）。

🔧 环境变量

运行本项目需在.env文件或Docker运行命令中添加以下环境变量：

TORBOX_API_KEY
TorBox API密钥，用于身份验证。可在此处获取。必填。

MOUNT_METHOD
挂载方式，必须为strm或fuse。参考上文选择方式。默认为strm，可选。

MOUNT_PATH
媒体文件的挂载路径。若在Docker中，此路径需对其他应用程序可访问；若本地运行（无Docker），需拥有此路径的所有权。必填。

🐳 Docker运行（推荐）

1. 确保服务器/计算机已安装Docker。安装指南见此处（可在指南中切换发行版）。
2. 编辑以下Docker命令，填入正确的环境变量和选项。更多Docker运行命令见https://github.com/TorBox-App/torbox-media-center/blob/main/docker.md%E3%80%82

bash
docker run -it -d \
    --name=torbox-media-center \
    --restart=always \
    --init \
    -v /home/$(whoami)/torbox:/torbox \
    -e TORBOX_API_KEY=<EDIT_THIS_KEY> \
    -e MOUNT_METHOD=strm \
    -e MOUNT_PATH=/torbox \
    anonymoussystems/torbox-media-center:latest

若偏好Docker Compose，可使用以下yaml配置（也可在https://github.com/TorBox-App/torbox-media-center/blob/main/docker-compose.yaml%E6%89%BE%E5%88%B0%EF%BC%89%EF%BC%9A

yaml
name: torbox-media-center
services:
    torbox-media-center:
        container_name: torbox-media-center
        stdin_open: true
        tty: true
        restart: always
        volumes:
            - /home/$(whoami)/torbox:/torbox
        environment:
            - TORBOX_API_KEY=<EDIT_THIS_KEY>
            - MOUNT_METHOD=strm
            - MOUNT_PATH=/torbox
        image: anonymoussystems/torbox-media-center:latest

也可使用GitHub仓库容器：ghcr.io/torbox-app/torbox-media-center:main

3. 等待文件挂载到本地系统。

🏠 本地运行（无Docker）

1. 确保已安装Python（v3.6及以上版本）。
2. 下载或克隆本仓库：

bash
git clone https://github.com/TorBox-App/torbox-media-center.git

或下载仓库压缩包https://github.com/TorBox-App/torbox-media-center/archive/refs/heads/main.zip%E5%B9%B6%E8%A7%A3%E5%8E%8B%E3%80%82

3. 创建.env文件或将.env.example重命名为.env。
4. 编辑.env文件，添加环境变量。
5. 安装依赖：

bash
pip3 install -r requirements.txt

6. 运行main.py脚本：

bash
python3 main.py

7. 等待文件挂载到本地计算机。

🆘 支持

如需支持，请发送邮件至或加入服务器此处。我们不提供源代码或协助盗版行为，仅提供技术支持。

🤝 贡献

欢迎贡献！

提交 commit 时请遵循Conventional Commits规范。我们会批准大多数拉取请求，欢迎参与！