🌐 Language

[![][github-release-shield]][github-release-link] [![][github-nightly-shield]][github-nightly-link] [![][github-license-shield]][github-license-link] [![][fossa-shield]][fossa-link] [![][telegram-shield]][telegram-link] [![][sponsor-shield]][sponsor-link]

[![][deepwiki-shield]][deepwiki-link] [![][zread-shield]][zread-link]

[![][rank-hellogithub-shield]][rank-hellogithub-link] [![][rank-trendshift-shield]][rank-trendshift-link] [![][rank-producthunt-shield]][rank-producthunt-link]

# 软件介绍 zyfun是一款免费、极简、全能的跨平台影音管家，一站式管理 T1-T4 全类型资源，内置多核播放器随心切换。独家老板键，一键隐身摸鱼无忧。用观影发现世界！

展开查看软件截图

| 影视 | 直播 | | :-----------------------------------------: | :--------------------------------------: | | ![影视](docs/assets/images/app-film.png) | ![直播](docs/assets/images/app-live.png) | | **历史** | **播放** | | ![历史](docs/assets/images/app-history.png) | ![播放](docs/assets/images/app-play.png) |

## 🌴 注意事项 - 仅此Github发布，请勿上当受骗；请各管理者不要宣传及引流本软件。 - 强烈倡导合法观影，本软件仅作为播放工具，不涉及资源存储或分发。 - 仅供个人学习交流之用，24小时内请自觉卸载，勿作商业用途。 - 前身来源于[ZY-Player](https://github.com/Hunlongyu/ZY-Player)，图标由@fourbeauty设计。 - 在开始使用前，请务必详读并同意用户协议，确保遵守相关规定。 ## 💻 跨平台说明 - **MacOS**: - 提供 arm64(苹果芯片)/x64(英特尔芯片)架构安装包 - 数据库/文件/插件/日志路径: `~/Library/Application Support/zyfun/` - 二进制路径: `~/.zy/bin/` - **Linux**: - 提供 arm64/x64架构-image/deb安装包 - 数据库/文件/插件/日志路径: `~/.config/zyfun/` - 二进制路径: `~/.zy/bin/` - **Windows**: - 提供 arm64/x64架构安装包 - 数据库/文件/插件/日志路径: `%USERPROFILE%\AppData\Roaming\zyfun\` - 二进制路径: `%USERPROFILE%\.zy\bin\` ## 🛠️ 下载安装 > **最新发布版下载**: 访问 [GitHub Releases页面](https://github.com/Hiram-Wong/zyfun/releases) 获取 > **最新开发版下载**: 访问 [GitHub Actions页面](https://github.com/Hiram-Wong/zyfun/actions/workflows/nightly-build.yml) 获取, 需登录Github账号 ### MacOS 安装后打开提示「文件已损坏」 ```bash sudo spctl --master-disable sudo xattr -cr /Applications/zyfun.app ``` ### Linux Appimage运行失败 > Running as root without --no-sandbox is not supported ```bash ./zyfun.AppImage --no-sandbox ``` > dlopen()：error loading libfuse.so.2 ```bash sudo apt-get install libfuse2 ``` > Exiting GPU process due to errors during initialization ```bash xhost + ``` ### Linux deb包安装失败 > Package libnss3-1d is not installed ```bash sudo apt-get install libnss3-1d ``` > Package libxss1 is not installed ```bash sudo apt-get install libxss1 ``` ### Linux rpm包安装失败 > Dependency check failed libXScrnSaver is needed ```bash sudo yum install epel-release sudo yum install libXScrnSaver ``` > Dependency check failed xdg-utils is needed ```bash sudo yum install xdg-utils ``` ## 📚 数据结构 > 请严格按照数据结构导入数据, 避免不必要的报错(如数据字段类型不匹配)

展开查看接口说明

```json { "analyze": [ { "id": "fddfb425-6fd9-0b39-459f-a21f69739a6e", // 唯一标识(UUID v4)，不可重复 "key": "51793af6-c923-5504-85db-0ef686624dec", // <3.4.0 启用> 业务唯一标识(建议不重复) "name": "Parse", // 名称(展示用) "url": "https://xxx.top/?jx=", // <3.4.1 **弃用**> 解析源地址(仅兼容旧版本) "api": "https://xxx.top/?jx=", // <3.4.1 启用> 解析源地址(推荐使用) "type": 0, // 解析类型(<=3.4.0: 0=web,1=json | >=3.4.1: 1=web,2=json) "flag": [], // <3.4.1 启用> 解析线路/标签标识 "headers": {}, // <3.4.0 启用> 请求头配置(预留字段) "script": "", // <3.4.1 启用> 执行脚本，仅 type=web 时生效 "isActive": true, // 是否启用(true=启用,false=禁用) "createdAt": 1768310498000, // <3.4.1 启用> 创建时间戳(ms) "updatedAt": 1768310498000 // <3.4.1 启用> 更新时间戳(ms) } ], "iptv": [ { "id": "fddfb425-6fd9-0b39-459f-a21f69739a6e", // 唯一标识(UUID v4)，不可重复 "key": "51793af6-c923-5504-85db-0ef686624dec", // <3.4.0 启用> 业务唯一标识(建议不重复) "name": "Iptv", // 名称(展示用) "url": "https://xxx.com/m3u/iptv.m3u", // <3.4.1 **弃用**> 直播源地址(仅兼容旧版本) "api": "https://xxx.com/m3u/iptv.m3u", // <3.4.1 启用> 直播源地址(推荐使用) "type": 1, // 解析类型(<=3.4.0: remote=远程,local=本地, manual=文本 | >=3.4.1: 1=远程,2=本地,3=文本) "epg": "https://epg.112114.eu.org/?ch={name}&date={date}", // 电子节目单地址[string] "logo": "https://epg.112114.eu.org/logo/{name}.png", // 台标地址[string] - 3.3.8启用该参数 "headers": {}, // <3.4.0 启用> 请求头配置(预留字段) "isActive": true, // 是否启用(true=启用,false=禁用) "createdAt": 1768310498000, // <3.4.1 启用> 创建时间戳(ms) "updatedAt": 1768310498000 // <3.4.1 启用> 更新时间戳(ms) } ], "channel": [ { "id": "fddfb425-6fd9-0b39-459f-a21f69739a6e", // 唯一标识(UUID v4)，不可重复 "name": "Channel", // 名称(展示用) "url": "https://xxx.com/m3u/iptv.m3u8", // <3.4.1 **弃用**> 播放地址(仅兼容旧版本) "api": "https://xxx.com/m3u/iptv.m3u8", // <3.4.1 启用> 播放地址(推荐使用) "logo": "https://xxx.com/logo/xxx.png", // <3.4.1 启用> 台标地址 "playback": "", // <3.4.1 启用> 预留回播参数 "group": "默认", // 分组 "createdAt": 1768310498000, // <3.4.1 启用> 创建时间戳(ms) "updatedAt": 1768310498000 // <3.4.1 启用> 更新时间戳(ms) } ], "sites": [ { "id": "fddfb425-6fd9-0b39-459f-a21f69739a6e", // 唯一标识(UUID v4)，不可重复 "key": "51793af6-c923-5504-85db-0ef686624dec", // <3.4.0 启用> 业务唯一标识(建议不重复) "name": "Film", // 名称(展示用) "api": "https://www.xxx.com/api.php/provide/vod/", // 接口地址 "playUrl": "", // 配合解析去url地址 "search": 0, // 是否支持搜索(<=3.4.0: 0= 关闭,1=聚合搜索,2=仅搜索 | >=3.4.1: true= 开启,false=关闭) "group": "切片", // 分组 "type": 1, // 适配器类型(0=T0_XML,1=T1_JSON,6=T4_DRPYS,7=T3_DRPY,8=T4_CATVOD,9=T3_XBPQ,10=T3_XYQ,11=T3_APPYSV2,12=T3_PY,13=T3_ALIST) "ext": "", // 扩展参数 "categories": "电视,影视", // 按顺序展示所配置的分类不配置则默认展示所有分类[string] "isActive": true // 是否启用(true=启用,false=禁用) "createdAt": 1768310498000, // <3.4.1 启用> 创建时间戳(ms) "updatedAt": 1768310498000 // <3.4.1 启用> 更新时间戳(ms) } ], "drive": [ { "id": "fddfb425-6fd9-0b39-459f-a21f69739a6e", // 唯一标识(UUID v4)，不可重复 "key": "51793af6-c923-5504-85db-0ef686624dec", // <3.4.0 启用> 业务唯一标识(建议不重复) "name": "alist", // 名称(展示用) "server": "http://alist.xxx.pro/", // 网盘地址 "showAll": false, // 是否展示全部(true=全部,false=仅视频) "startPage": "", // 开始页路径 "search": false, // 是否支持搜索(true=启用,false=禁用) "headers": "{}", // 请求头(预留字段) "params": "{}", // 参数(预留字段) "isActive": true // 是否启用(true=启用,false=禁用) } ], // <3.4.1 **弃用**> "setting": [ { "version": "3.3.2", // <3.2.2 启用> 当前版本(一定要根据实际填写,不然数据库执行会报错) "theme": "system", // 主题 (<=3.4.0: auto=跟随系统,light=亮色,dark=暗色 | system=跟随系统,light=亮色,dark=暗色) "lang": "zh_CN", // <3.3.4 启用> 语言(<=3.4.0: zh_CN=简体中文,en_US=英文 | system=更随系统,zh_CN=简体中文,zh_TW=繁体中文,en_US=英文) "zoom": 1, // <3.4.1 启用> 界面缩放比例(预留) "proxy": { "type": "none", // 代理类型(system=系统代理,custom=自定义代理,direct=直连) "url": "", // 代理地址(支持socks5/http/https协议) "bypass": "" // 忽略主机名 }, <3.4.1 启用> 代理设置 "defaultHot": "kylive", // <3.4.1 **弃用**> 热搜(kylive=酷云数据,enlightent=云合数据) "hot": "kylive", // <3.4.1 启用> 热搜(baidu=百度,douban=豆瓣,enlightent=云合,komect=移动爱家,kylive=酷云,quark=夸克) "defaultSearchRecommend": "site", // 搜索推荐 site:站点 quark:夸克 baidu:百度 douban:豆瓣弃用 "defaultSearchType": "site", // <3.4.1 **弃用**> 全局搜索模式 site:本站 group:组内 all:全部 "defaultFilterType": false, // <3.3.7 启用, 3.4.1 **弃用**> 影视搜索过滤关键词 "site": { "searchMode": "site", // 全局搜索模式 site:本站 group:组内 all:全部 "filterMode": false, // 影视搜索过滤关键词 }, // <3.4.1 启用> 影视设置 "defaultIptvEpg": "https://epg.112114.eu.org/?ch={name}&date={date}", // <3.4.1 **弃用**> iptv电子节目单(name=频道名称 date=日期) "defaultIptvLogo": "https://epg.112114.eu.org/logo/{name}.png", // <3.4.1 **弃用**> iptv台标(name=频道名称) "iptvSkipIpv6": true, // <3.3.8 **弃用**> iptv是否跳过ipv6节目 "iptvMarkIp": true, // <3.3.8 启用, 3.4.1 **弃用**> iptv标识IP类型 "iptvThumbnail": true, // <3.4.1 **弃用**> iptv是否显示缩略图 "iptvStatus": true, // <3.3.8 **弃用**> iptv是否检测延迟 "iptvDelay": true, // <3.3.8 启用, 3.4.1 **弃用**> iptv是否检测延迟 "live": { "ipMark": true, // IP类型 "thumbnail": false, // 缩略图 "delay": false, // 延迟测速 "epg": "https://epg.112114.eu.org/?ch={name}&date={date}", // 电子节目单(name=频道名称 date=日期) "logo": "https://epg.112114.eu.org/logo/{name}.png", // 台标(name=频道名称) }, // <3.4.1 启用> 直播设置 "defaultSite": "51793af6-c923-5504-85db-0ef686624dec", // site 默认源标识 "defaultIptv": "993841fe-5e91-5e5d-35d6-5be81822960b", // iptv 默认源标识 "defaultAnalyze": "fddfb425-6fd9-0b39-459f-a21f69739a6e", // analyze 默认源标识 "defaultDrive": "3293dc45-cf14-9c66-3028-5b7765b240b7", // <3.4.1 **弃用**> drive 默认源标识 "defaultViewCasual": "", // <3.3.4 启用 3.3.5 **弃用**> 随心看 "barrage": { "url": "", // 弹幕地址 "id": "name", // 弹幕接口返回数据对应的id "key": "danmuku", // 弹幕接口返回数据对应的key "support": ["qq", "qiyi", "youku", "mgtv"], // 弹幕支持的线路 "start": "0", <3.4.1 **弃用**> // 返回数据对应的开始时间下标 "time": 0, // <3.4.1 启用> 返回数据对应的开始时间下标 "mode": "1", // <3.4.1 **弃用**> 返回数据对应的位置下标 "type": 1, // <3.4.1 启用> 返回数据对应的位置下标 "color": 2, // 返回数据对应的颜色下标(<=3.4.0: string | >=3.4.1: number) "content": "4" // <3.4.1 **弃用**> 返回数据对应的内容下标 "text": 4 // <3.4.1 启用> 返回数据对应的内容下标 }, // <3.3.4 启用> 弹幕参数 "analyzeFlag": ["youku", "qq", "iqiyi", "qiyi", "letv", "leshi", "sohu", "tudou", "pptv", "mgtv", "imgo"], // <3.4.1 **弃用**> 解析标识 "broadcasterType": "xgplayer", // <3.3.4 **弃用**> 播放器(xgplayer=西瓜播放器,dplayer=呆呆播放器,custom=调外部播放器) "externalPlayer": "", // <3.3.4 **弃用**> 调外部播放器(类型为custom启用) "playerMode": { "type": "xgplayer", // 播放器(xgplayer=西瓜播放器,artplayer=艺术播放器,custom=调外部播放器) "external": "" // 调外部播放器(类型为custom启用) }, // <3.3.4 启用, 3.4.1 **弃用**> "player": { "type": "xgplayer", // 播放器(xgplayer=西瓜播放器,artplayer=艺术播放器,custom=调外部播放器) "external": "" // 调外部播放器(类型为custom启用) }, // <3.4.1 启用> "softSolution": false, // 软解(预留字段 true=启用,false=禁用) "skipStartEnd": false, // <3.3.5 **弃用**> 是否跳过首尾空白 "agreementMask": true, // <3.4.1 **弃用**> 是否同意协议 "disclaimer": true, // <3.4.1 启用> 是否同意协议 "recordShortcut": "Shift+Command+Z", // <3.4.1 **弃用**> 老板键 "bossKey": "Shift+Command+Z", // <3.4.1 启用> 老板键 "snifferType": "pie", // <3.3.4 **弃用**> 嗅探模式(pie=内置嗅探,iframe=原生嗅探) "snifferMode": { "type": "pie", // 嗅探模式(pie=内置嗅探,custom=三方嗅探) "url": "" // 三方嗅探接口(类型为custom时启用) }, // <3.3.4 启用, 3.4.1 **弃用**> "sniffer": { "type": "cdp", // 嗅探模式(cdp=内置嗅探,custom=三方嗅探) "url": "" // 三方嗅探接口(类型为custom时启用) }, // <3.4.1 启用> "selfBoot": false, // <3.4.1 **弃用**> 是否开机自启动 "autoStart": false, // <3.4.1 启用> 是否开机自启动 "hardwareAcceleration": true, // 是否启用硬件加速 "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Safari/537.36", // User-Agent "dns": "" // <3.3.7 启用> DNS-over-HTTP "webdavUrl": "https://dav.jianguoyun.com/dav/", // <3.3.4 **弃用**> webdav同步盘地址 "webdavUsername": "", // <3.3.4 **弃用**> webdeav用户名 "webdavPassword": "", // <3.3.4 **弃用**> webdav密码 "webdav": { "sync": false, // 自动同步 "data": { "url": "https://dav.jianguoyun.com/dav/", // webdav同步盘地址 "user": "", // webdav用户名 "password": "" // webdav密码 } }, // <3.3.4 启用, 3.4.1 **弃用**> "cloud": { "sync": false, // 自动同步 "type": "webdav", // 备份类型(webdav=webdav同步盘, icloud=icloud云盘仅mac) "data": { "url": "https://dav.jianguoyun.com/dav/", // webdav同步盘地址 "user": "", // webdav用户名 "password": "" // webdav密码 } // 仅类型为webdav启用 }, // <3.4.1 启用> "ai": { "server": "", // AI服务器地址 "key": "", // API密钥 "model": "gpt-3.5-turbo" // 模型名称 }, // <3.3.5 启用, 3.4.1 **弃用**> "aigc": { "type": "openai", // AI类型(仅支持openai) "server": "", // AI服务器地址 "key": "", // API密钥 "model": "gpt-3.5-turbo" // 模型名称 }, // <3.4.1 启用> AI设置 "timeout": 5000, // <3.3.5 启用> 全局请求超时(ms) "restoreWindowPositionAndSize": false, // <3.3.7 **弃用**> 是否记录窗口位置 "windowPosition": { "status": false, // 是否记录窗口位置 "position": { "width": 1000, "height": 640 }, // <3.3.7 **弃用**> 窗口位置 "position_main": { "width": 1000, "height": 640 }, // <3.3.7 启用> 记录主窗口位置 "position_play": { "width": 875, "height": 550 } // <3.3.7 启用> 记录播放窗口位置 }, // <3.4.1 **弃用**> "debug": false, // <3.3.7 启用> 用于部分调试 } ] } ```

## 🤝 参与贡献以下是您可以做出贡献的一些方式： - **贡献代码**：开发新功能或优化现有代码 <[开发文档](docs/Develop.md)> - **修复错误**：提交您发现的任何错误的修复 <[提交规范](docs/Conventional_Commits.md)> - **维护问题**：帮助管理GitHub问题 - **产品设计**：参与设计讨论 - **编写文档**：改进用户手册和指南 - **社区参与**：加入讨论并帮助用户 [![][github-contributors-shield]][github-contributors-link] ## 🌟 Star历史

## 💰 金主爸爸 - [NodeSupport](https://github.com/NodeSeekDev/NodeSupport) 赞助了本项目 - [![image](https://s2.loli.net/2025/04/09/JMyQZUKY2bX4G3q.png)](https://yxvm.com/) [github-release-shield]: https://img.shields.io/github/v/release/Hiram-Wong/zyfun?label=Release&logo=github [github-release-link]: https://github.com/Hiram-Wong/zyfun/releases [github-nightly-shield]: https://img.shields.io/github/actions/workflow/status/Hiram-Wong/zyfun/nightly-build.yml?label=NightlyBuild&logo=github [github-nightly-link]: https://github.com/Hiram-Wong/zyfun/actions/workflows/nightly-build.yml [github-contributors-shield]: https://openomy.app/svg?repo=Hiram-Wong/zyfun&chart=bubble&latestMonth=12 [github-contributors-link]: https://openomy.app/github/Hiram-Wong/zyfun [github-license-shield]: https://img.shields.io/github/license/Hiram-Wong/zyfun?label=License&logo=gnu [github-license-link]: https://github.com/Hiram-Wong/zyfun/blob/main/LICENSE.txt [fossa-shield]: https://app.fossa.com/api/projects/git%2Bgithub.com%2FHiram-Wong%2Fzyfun.svg?type=shield [fossa-link]: https://app.fossa.com/projects/git%2Bgithub.com%2FHiram-Wong%2Fzyfun?ref=badge_shield [sponsor-shield]: https://img.shields.io/badge/赞助支持-FF6699.svg?logo=githubsponsors&logoColor=white [sponsor-link]: https://ko-fi.com/hiramwong [telegram-shield]: https://img.shields.io/badge/IM-Telegram-0088CC?logo=telegram [telegram-link]: https://t.me/+IOovrYLP7gYwYmNl [readmex-shield]: https://raw.githubusercontent.com/CodePhiliaX/resource-trusteeship/main/readmex.svg [readmex-link]: https://readmex.com/Hiram-Wong/zyfun [deepwiki-shield]: https://deepwiki.com/badge.svg [deepwiki-link]: https://deepwiki.com/Hiram-Wong/zyfun [zread-shield]: https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff [zread-link]: https://zread.ai/Hiram-Wong/zyfun [rank-hellogithub-shield]: https://api.hellogithub.com/v1/widgets/recommend.svg?rid=c54bf4d457b64ee7a84fd1ea0b36419a [rank-hellogithub-link]: https://hellogithub.com/repository/Hunlongyu/ZY-Player [rank-trendshift-shield]: https://trendshift.io/api/badge/repositories/9742 [rank-trendshift-link]: https://trendshift.io/repositories/9742 [rank-producthunt-shield]: https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1019733&theme=light [rank-producthunt-link]: https://www.producthunt.com/products/zyfun?embed=true&utm_source=badge-featured&utm_medium=badge&utm_source=badge-zyfun