fntv-electron

fntv-electron 桌面客户端

飞牛影视桌面客户端，基于Electron构建，提供更好的桌面体验和增强功能。

演示视频

✨ 主要功能

• 原生桌面体验 - 基于飞牛影视Web端构建的桌面应用，提供类原生体验
• 多账户管理 - 支持自动登录，支持多账户管理，自由切换账户和服务器
• 远程访问 - 支持使用FN Connect，通过FN ID登录实现远程访问
• 硬解播放 - 使用MPV播放器，支持H264 / HEVC / VP9 / AV1等编码格式
• 直链播放 - 适配官方直链 / STRM播放，默认使用302重定向，可以在托盘处调整为nas代理模式
• 进度回传 - MPV播放器支持实时将进度回传到飞牛服务器
• 弹幕支持 - MPV播放器支持弹幕自动匹配加载，无法匹配时支持手动搜索
• 视频增强 - 内置anime4K着色器以及对应预设模式
• 智能跳过 - 可在MPV播放器界面设置。支持三种跳过片头片尾模式：章节检查，手动设置片头片尾，快捷键跳过固定时长
• 跨平台支持 - 支持windows、macos和linux

爱发电

您的每一次 star ⭐ 和 赞助 都是我持续优化的动力。让我们一起维护这个用爱发电的项目！

赞助者

感谢这些来自爱发电的赞助者：

点我 打开/关闭 赞助者列表

爱发电用户_41cb9

( 1 次赞助, 共 ￥10 ) 留言:

爱发电用户_7kDX

( 1 次赞助, 共 ￥10 ) 留言:

爱发电用户_5251e

( 1 次赞助, 共 ￥20 ) 留言:

爱发电用户_ec601

( 1 次赞助, 共 ￥10 ) 留言: 不错不错

爱发电用户_7WxX

( 1 次赞助, 共 ￥10 ) 留言: 加油，支持一杯蜜雪

1

( 1 次赞助, 共 ￥10 ) 留言: fntv

爱发电用户_4514c

( 1 次赞助, 共 ￥10 ) 留言:

嬴游仙人莫迪

( 1 次赞助, 共 ￥60 ) 留言: 谢谢，我是真的很喜欢...

爱发电用户_e6g3

( 1 次赞助, 共 ￥20 ) 留言: 给几个建议我是mac...

安装方法

预编译版本

前往 Releases页面 下载最新版本：

• 文件名: FNMedia_${version}_${os}_${arch}.${ext}

1.字段含义：

• version：版本号
• os：操作系统
• arch：系统架构
• ext：文件扩展名

2.安装步骤

• windows直接安装即可使用
• macos请使用brew安装mpv

brew install mpv
# 安装dmg后执行
sudo find "/Applications/飞牛影视.app" -exec xattr -d com.apple.quarantine {} \; 2>/dev/null

• linux请先安装mpv播放器(版本>0.37.0)再使用，插件前往fntv-mpv 自行安装，可以参考issue#54

从源码构建

1. 克隆仓库：

git clone https://github.com/QiaoKes/fntv-electron.git
cd fntv-electron

1. 安装依赖：

npm i

1. 运行开发模式：

npm start

1. 构建安装包：

npm run build:win
npm run build:mac
npm run build:linux

常用问题Q&A

1. mpv播放器功能有点少，怎么客制化，想添加补帧滤镜等？

1. 自动方法 克隆fntv-mpv仓库，自己改一下相关配置：fntv-mpv-config
2. 手动方法 打开你安装目录的third_party，只修改third_party\fntv-mpv\portable_config下面的插件，其余的不要动。其中input.conf是快捷键。

注意重新安装或者更新，会清空安装目录，注意备份你的mpv插件目录。

2. 能否支持potplayer？

目前我这边没有使用potplayer的需求，如果需要的话可以自行修改源码适配一下，已留好interface，只需要适配。

3. 弹幕相关问题？

弹幕问题查看uosc_danmaku的文档，根据文档内容调整配置。

4. 登录完客户端后，如果服务器连接不上登录会超时卡透明屏，无法切换或修改服务器配置，卸载重装也不行

去C:\Users\{你的计算机用户名}\.fntv 下面把config.json删除了，因为连接成功后实际上加载的还是飞牛网页端，没响应当然会透明了。

5. 打开弹幕视频掉帧

打开弹幕时，默认开启fps平滑滤镜，比较吃性能，不需要可以去安装目录下的third_party\fntv-mpv\portable_config\script-opts下uosc_danmaku.conf关闭相关配置

6. 视频播放卡慢，双显卡，调用时发现使用核显

以下两种方法任选其一：

1. NVIDIA控制面板-管理3D设置-程序设置-添加飞牛影视-应用
2. 设置-系统-屏幕-图形显示-添加飞牛影视-选择高性能

⌨️ MPV播放器

1. 快捷键

部分快捷键兼容potpolyer
查看安装目录下
third_party\fntv-mpv\portable_config\input.conf

1. MPV配置由以下仓库单独管理: fntv-mpv-config
2. 预设着色器方案 mpv.conf

特别感谢

本项目参考以下开源项目：

• enable-chromium-hevc-hardware-decoding - Chromium HEVC硬解码支持
• electron-media-patch - Electron硬解码补丁
• fnToPotplayer - 飞牛影视调用Potplayer
• fnos-tv - fnos-tv 支持弹幕的飞牛影视
• mpv弹幕插件 - uosc_danmaku 基于uosc的弹幕插件

Star History

许可证

本项目采用 GPL3.0 许可证

Copyright (c) 2025 Tag mig hånden

温馨提示：本项目为第三方客户端，与飞牛影视官方无关。使用前请确保遵守相关服务条款。