Gnomecast 项目技术文档

Gnomecast 项目技术文档

gnomecast Chromecast local files from Linux - supports MKV, subtitles, 5.1 sound and 4K! 项目地址: https://gitcode.com/gh_mirrors/gn/gnomecast

1. 安装指南

1.1 系统要求

• Linux 操作系统
• 已安装 ffmpeg、python3-pip 和 python3-gi

1.2 安装步骤

1. 打开终端并运行以下命令以安装必要的依赖：

   sudo apt install ffmpeg python3-pip python3-gi
   

2. 使用 pip3 安装 gnomecast：

   pip3 install gnomecast
   

3. 如果你在虚拟环境中安装，请确保包含 --system-site-packages 参数以获取 GTK 绑定：

   mkvirtualenv --system-site-packages myenv
   pip3 install gnomecast
   

2. 项目的使用说明

2.1 启动 Gnomecast

安装完成后，注销并重新登录系统。Gnomecast 将出现在你的应用程序启动器中。

你也可以通过命令行启动 Gnomecast：

gnomecast

或者：

python3 -m gnomecast

2.2 配置 HTTP 服务器端口

你可以通过环境变量 GNOMECAST_HTTP_PORT 配置 HTTP 服务器的端口：

GNOMECAST_HTTP_PORT=8010 python3 -m gnomecast

2.3 播放文件

支持播放音频和视频文件（ffmpeg 支持的任何格式）。你可以拖放文件到主界面进行播放。

2.4 字幕支持

Gnomecast 支持嵌入式和外部 SRT 文件的字幕。字幕将被转换为 WebVTT 格式并通过 Chromecast 的 API 重新附加到视频中。

3. 项目API使用文档

3.1 环境变量

• GNOMECAST_HTTP_PORT: 配置 HTTP 服务器的端口。

3.2 命令行接口

• gnomecast: 启动 Gnomecast 应用程序。
• python3 -m gnomecast: 通过 Python 模块启动 Gnomecast。

4. 项目安装方式

4.1 通过 pip3 安装

pip3 install gnomecast

4.2 在虚拟环境中安装

mkvirtualenv --system-site-packages myenv
pip3 install gnomecast

5. 常见问题

5.1 文件无法播放

如果文件无法播放，请点击信息按钮并选择“报告文件无法播放”按钮，以便开发者修复问题。

5.2 测试

你可以通过以下命令运行测试：

python3 test_gnomecast.py

6. 致谢

感谢以下项目和社区的支持：

• pychromecast
• pycaption
• ffmpeg

以及所有让该项目登上 Hacker News 首页和 GitHub 趋势榜的贡献者！

gnomecast Chromecast local files from Linux - supports MKV, subtitles, 5.1 sound and 4K! 项目地址: https://gitcode.com/gh_mirrors/gn/gnomecast