这个项目能做什么

NymphCast 是一个软件解决方案，可将您选择的硬件转变为电视或有源音箱的音视频源。它支持通过网络从客户端设备或媒体服务器流式传输音视频，也支持将互联网媒体流式传输到 NymphCast 服务器，由客户端设备控制或直接在接收器上控制。服务器支持用 AngelScript 编写的 NymphCast 应用（目前为预览版）来扩展功能，例如在服务器端支持第三方音视频流协议，以及在客户端应用中自定义用户界面。 除 GUI（“智能电视”）模式外，NymphCast 都需要一个客户端设备。服务器应用（接收器）运行在目标设备上，而客户端设备则充当遥控器。客户端核心功能通过 NymphCast 库提供。 ## 使用场景 - **NymphCast Audio**：仅音频接收器模式，配置文件为 `nymphcast_audio_config.ini`。 - **NymphCast Video**：音频与视频接收器模式，配置文件为 `nymphcast_video_config.ini`。 - **NymphCast ScreenSaver**：类似视频模式，但在不播放内容时显示基于图像的屏保，使用 `nymphcast_screensaver_config.ini`。 - **NymphCast GUI**：类似视频模式，但启用了独立 GUI 模式（智能电视）（实验性），使用 `nymphcast_gui_config.ini`。 ## 网络端口 NymphCast 服务器使用 UDP 端口 4004 进行发现，使用 TCP 端口 4004 进行播放。运行 NymphCast MediaServer 的系统还需要 UDP 和 TCP 端口 4005 可访问。如有防火墙规则，请确保这些端口在白名单中。 ## 功能与状态 - **文件流式传输**（100%）：将媒体文件从客户端流式传输到服务器。 - **字幕与流**（75%）：支持字幕和流选择；支持嵌入式位图（如 PGS）字幕。文本和外部字幕将在 v0.2 中添加。 - **多播**（85%）：同步多房间播放（v0.1 中为实验性）。 - **MediaServer**（100%）：从 NymphCast MediaServer 实例流式传输。 - **URL 流式传输**（100%）：从 URL 流式传输。 - **编解码器支持**（100%）：支持 ffmpeg 支持的所有编解码器。 **实验性功能：** - **SmartTV**（75%）：独立 GUI 模式，集成了基于 EmulationStation 的 GUI。 - **应用**（25%）：基于 AngelScript 的应用，带有 CLI 和基于 HTML 的 GUI 实现。 - **本地媒体**（25%）：在 v0.2-alpha0 中实现了基本的本地媒体播放。 ## NymphCast 生态系统 - **NymphCast Server**：客户端的接收端点。 - **LibNymphCast**：用于开发 NymphCast 客户端的库。 - **NymphCast Client**：基于 CLI 的客户端。 - **NymphCast Player**：基于 Qt 的图形客户端和 SDK 参考实现。 - **NymphCast MediaServer**：用于向客户端提供媒体内容的服务器应用。 ## 平台支持 NymphCast Player 客户端已在 Windows（7、10）、Linux（x86、ARM：Arch、Debian）、Android（8+）、FreeBSD（14.1）和 Haiku（R1 Beta 5）上编译和使用。服务器可在任何支持 C++17 工具链以及 LibPoco 和 ffmpeg 依赖的平台上运行，包括 Windows、MacOS、Linux 和 BSD。已测试的平台包括 x86_64 Windows、Linux、FreeBSD、Haiku、Raspberry Pi 4（最高 1080p 24 FPS h.264），以及其他具有不同硬件加速支持的平台。 ## 入门指南 要开始使用 NymphCast，您需要一个用于服务器的设备（可能是 SBC 或 Linux 系统）。发布版本可在 GitHub 上获取，并提供 FreeBSD、Alpine Linux 和 PostmarketOS 的软件包。还提供 Android 和 Windows 的预编译二进制文件。服务器二进制文件可以通过配置标志启动，例如 `./nymphcast_server -c nymphcast_audio_config.ini`。服务器监听所有网络接口，并支持 `-v` 等选项来输出版本信息。 ## 从源代码构建 服务器和播放器的构建说明在 `doc/` 文件夹中提供。仓库包含服务器、客户端 SDK 和 NymphCast Player 客户端的源代码。 ## 开发者指南 开发重点在服务器和协议上。鼓励第三方贡献服务器端应用支持。文档托管在 Nyanko 网站上。 ## 许可证 NymphCast 完全开源，采用 3-clause BSD 许可证。该项目依靠通过 Ko-Fi 或直接捐赠来支持持续开发。