🌐 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]
Software Introduction
zyfun is a free, minimalist, all-in-one cross-platform media manager, providing one-stop management for all T1-T4 resource types, with a built-in multi-core player for seamless switching. Exclusive boss key, one-click stealth for worry-free leisure. Discover the world through watching movies!
Expand to view software screenshots
| Movies | Live |
| :----------------------------------------: | :--------------------------------------: |
|
|
|
| History | Play |
|
|
|
🌴 Notes
- Only released on Github, do not be deceived; administrators, please do not promote or direct traffic to this software.
- Strongly advocate legal viewing; this software is only a playback tool and does not involve resource storage or distribution.
- For personal study and communication only; please uninstall within 24 hours and do not use for commercial purposes.
- Originated from ZY-Player, icon designed by @fourbeauty.
- Before you start using, please read and agree to the user agreement to ensure compliance with relevant regulations.
💻 Cross-Platform Instructions
- MacOS:
- Provides arm64 (Apple chip)/x64 (Intel chip) architecture installation package
- Database/files/plugins/logs path:
~/Library/Application Support/zyfun/ - Binary path:
~/.zy/bin/ - Linux:
- Provides arm64/x64 architecture -image/deb installation package
- Database/files/plugins/logs path:
~/.config/zyfun/ - Binary path:
~/.zy/bin/ - Windows:
- Provides arm64/x64 architecture installation package
- Database/files/plugins/logs path:
%USERPROFILE%\AppData\Roaming\zyfun\ - Binary path:
%USERPROFILE%\.zy\bin\
🛠️ Download and Installation
Latest Release Download: Visit GitHub Releases Page to get it
Latest Development Build Download: Visit GitHub Actions Page to get it, requires Github login
MacOS prompts "File is damaged" after installation
sudo spctl --master-disable
sudo xattr -cr /Applications/zyfun.appLinux Appimage fails to run
Running as root without --no-sandbox is not supported
./zyfun.AppImage --no-sandboxdlopen(): error loading libfuse.so.2
sudo apt-get install libfuse2Exiting GPU process due to errors during initialization
xhost +Linux deb package installation failed
Package libnss3-1d is not installed
sudo apt-get install libnss3-1dPackage libxss1 is not installed
sudo apt-get install libxss1Linux rpm package installation failed
Dependency check failed: libXScrnSaver is needed
sudo yum install epel-release
sudo yum install libXScrnSaverDependency check failed xdg-utils is needed
sudo yum install xdg-utils📚 Data Structure
Please strictly follow the data structure when importing data to avoid unnecessary errors (such as data field type mismatches).
Expand to view API documentation
{
"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 启用> 用于部分调试
}
]
}
🤝 Contributing
Here are some ways you can contribute:
- Contribute Code: Develop new features or optimize existing code <Development Documentation>
- Fix Bugs: Submit fixes for any bugs you find <Submission Guidelines>
- Maintain Issues: Help manage GitHub issues
- Product Design: Participate in design discussions
- Write Documentation: Improve user manuals and guides
- Community Engagement: Join discussions and help users
🌟 Star History
💰 Sponsors
- NodeSupport sponsored this project

[github-release-shield]: https://img.shields.io/github/v/release/Hiram-Wong/ZyPlayer?label=Release&logo=github [github-release-link]: https://github.com/Hiram-Wong/ZyPlayer/releases [github-nightly-shield]: https://img.shields.io/github/actions/workflow/status/Hiram-Wong/ZyPlayer/nightly-build.yml?label=NightlyBuild&logo=github [github-nightly-link]: https://github.com/Hiram-Wong/ZyPlayer/actions/workflows/nightly-build.yml [github-contributors-shield]: https://openomy.app/svg?repo=Hiram-Wong/ZyPlayer&chart=bubble&latestMonth=12 [github-contributors-link]: https://openomy.app/github/Hiram-Wong/ZyPlayer [github-license-shield]: https://img.shields.io/github/license/Hiram-Wong/ZyPlayer?label=License&logo=gnu
[github-license-link]: https://github.com/Hiram-Wong/ZyPlayer/blob/main/LICENSE [fossa-shield]: https://app.fossa.com/api/projects/git%2Bgithub.com%2FHiram-Wong%2FZyPlayer.svg?type=shield [fossa-link]: https://app.fossa.com/projects/git%2Bgithub.com%2FHiram-Wong%2FZyPlayer?ref=badge_shield [sponsor-shield]: https://img.shields.io/badge/Sponsorship-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/ZyPlayer [deepwiki-shield]: https://deepwiki.com/badge.svg [deepwiki-link]: https://deepwiki.com/Hiram-Wong/ZyPlayer [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/ZyPlayer
[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
--- Tranlated By Open Ai Tx | Last indexed: 2026-02-01 ---