一、软件简介

FairyPlayer 是一款面向日常播放与进阶处理场景的多媒体播放器，提供 Windows 与 Linux 双版本。
它不仅支持本地音视频播放，还支持在线流媒体（M3U8）播放，并提供截图、媒体信息查看、转码与封装等实用功能。

无论是普通用户看片听歌，还是内容创作者做素材处理，FairyPlayer 都能提供稳定、直观的使用体验。

二、核心功能与使用说明

1）本地媒体播放

FairyPlayer 支持常见音视频格式的本地播放，可用于电影、课程、录屏、音乐等场景。

使用方法：

1. 打开 FairyPlayer。
2. 点击“打开文件”选择本地媒体，或直接将文件拖拽到播放器窗口。
3. 使用进度条进行快进/回退，按需调节音量与播放状态。

适用场景：

• 本地视频播放
• 音乐试听
• 教学资料观看

2）在线流媒体播放（M3U8）

支持 M3U8 地址播放，适合直播流、课程回放或网络点播链接。

使用方法：

1. 在地址输入区域粘贴 M3U8 链接。
2. 点击“播放”开始加载。
3. 网络稳定时可获得更流畅的播放体验。

说明：

• 若链接失效、源站限制或网络不稳，可能导致播放失败或缓冲。
• 建议先确认链接可用后再导入播放器。

3）媒体信息查看

可查看当前媒体的关键参数，便于转码前评估素材质量与兼容性。

可查看内容：

• 时长
• 分辨率
• 编码格式
• 码率
• 音频/视频轨道信息

适用场景：

• 判断是否需要转码
• 检查素材参数是否符合发布要求

4）视频截图

支持在播放过程中截取当前画面，导出图片文件。

使用方法：

1. 播放到目标时间点。
2. 点击“截图”功能按钮。
3. 程序自动输出截图文件（PNG）。

适用场景：

• 制作封面
• 内容预览图生成
• 问题反馈定位

5）转码与封装

可对媒体文件进行格式处理，提升兼容性或输出效率。

功能说明：

• 转码：将素材转换为通用格式（如 H.264 + AAC）。
• 封装：不重编码，仅更换容器格式，速度更快。

建议流程：先查看媒体信息，再选择“转码”或“封装”，可减少失败概率并提升处理效率。

三、Windows 与 Linux 使用方式

Windows

解压发布包后，双击 FairyPlayer.exe 即可启动。

Linux

进入程序目录后运行：

./run.sh

如果提示无执行权限，可先执行：

chmod +x run.sh FairyPlayer

四、目录结构说明（Windows / Linux）

Windows 版本目录说明

• FairyPlayer.exe：主程序入口
• bin/：运行依赖组件目录
• dlls/：动态链接库目录
• images/（或 img/）：界面图标与图片资源
• logs/（若存在）：运行日志目录

注意：Windows 下请保持目录完整，不要只单独拷贝 exe 文件。

Linux 版本目录说明

• FairyPlayer：Linux 主可执行文件
• run.sh：推荐启动脚本
• code/：原生模块与 FFmpeg 相关运行组件
• images/（或 img/）：界面图标与图片资源
• logs/（若存在）：运行日志目录

注意：Linux 下优先使用 run.sh 启动，且不要删除 code/ 目录。

五、发布说明

• FairyPlayer 采用独立目录发布，不是单文件打包。
• Windows 请保留 FairyPlayer.exe
bin/
dlls/ 与资源目录。
• Linux 请保留 FairyPlayer
run.sh
code/ 与资源目录。
• images/（或 img/）为界面资源目录，属于运行必需文件。