@@ -3,106 +3,117 @@
</p>
<p align="center"><strong>Entryway</strong></p>
<p align="center">多服务器聚合管理的跨平台媒体客户端,支持 Jellyfin 和 Emby 。</p>
<p align="center">A multi-server aggregation media client for Jellyfin & Emby — Android, Android TV & Window s.</p>
<p align="center"><a href="https://www.yamby.cn">官方网站 | Official Website</a></p>
<p align="center">一扇门,通往你的全部影音。把 Emby、Jellyfin、Plex、飞牛影视、极影视、音乐服务器、IPTV 与点播站,连同网盘、NAS 和本地文件,收进同一个客户端 。</p>
<p align="center">One entryway to all your media — a client for Emby, Jellyfin, Plex, fnOS, ZSpace, music servers, IPTV and VOD sites, cloud drives, NAS shares and local file s.</p>
<p align="center"><a href="https://entryway.top"><strong>官方网站 entryway.top</strong></a> | <a href="https://entryway.top"> Official Website</a></p>
<p align="center">
<img src="https://img.shields.io/badge/Platform-Android%20%7C%20Android_TV%20%7C%20Windows-3DDC84?style=flat-square" alt="Platform ">
<img src="https://img.shields.io/badge/Server-Jellyfin%20%7C%20Emby-AA0000?style=flat-square" alt="Server ">
<img src="https://img.shields.io/badge/License-MIT-blue ?style=flat-square" alt="License ">
<img src="https://img.shields.io/badge/Android-1.0.11-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Android 1.0.11 ">
<img src="https://img.shields.io/badge/Android_TV-1.0.10-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Android TV 1.0.10 ">
<img src="https://img.shields.io/badge/Windows-开发中-8A8F98 ?style=flat-square" alt="Windows ">
<img src="https://img.shields.io/badge/Server-Emby%20%7C%20Jellyfin%20%7C%20Plex%20%7C%20fnOS%20%7C%20ZSpace-AA5CC3?style=flat-square" alt="Server">
</p>
---
## 最新版本 | Latest Release
本仓库是 Entryway 的发布仓库:安装包以 Release 附件形式提供,客户端的更新检测也从这里读取版本。手机、TV、Windows 三端**独立发版**,各自使用 `android-phone-v*` 、`android-tv-v*` 、`windows-v*` 前缀的 Tag。
**全局标签 `v0.24.0` ** (各端应用版本独立;手机版为 Preview, TV 与 Windows 为 Debug)
## 最新版本 | Latest Releases
| 平台 | 应用 版本 | 构建号 | 下载 |
| --- | --- | --- | --- |
| Android 手机版 | 0.24.0 | 45 | [ `entryway-preview-0.24.0.apk` ]( https://gitea.yamby.cn/yusheng /Entryway_Release/releases/download/v0.24.0 /entryway-p review-0.24.0 .apk ) |
| Android TV 版 | 0.18.1 | 39 | [ `Entryway-tv-debug-0.18.1.apk` ]( https://gitea.yamby.cn/yusheng/Entryway_Release/releases/download/v0.24.0/Entryway-tv-debug-0.18.1 .apk ) |
| Windows x64 | 0.18.0 | 37 | [ `Entryway_0.18.0+37_Windows_x64_Setup.exe` ](https://gitea.yamby.cn/yusheng/Entryway_Release/releases/download/v0.24.0/Entryway_0.18.0+37_Windows_x64_Setup.exe ) |
| 平台 | 版本 | 构建号 | 系统要求 | 下载(Gitea) | 镜像(GitHub) |
| --- | --- | ---: | --- | --- | --- |
| Android 手机 | **1.0.11 ** | 71 | Android 8.1+ · arm64 | [entryway-release-1.0.11-arm64-v8a.apk ]( https://gitea.yamby.cn/yusheng/Entryway_Release/releases/download/android-phone-v1.0.11/entryway-release-1.0.11-arm64-v8a.apk ) | [ 下载 ]( https://github.com/YuSheng-Jack /Entryway_Release/releases/download/android-phone-v1.0.11 /entryway-release-1.0.11-arm64-v8a .apk ) |
| Android TV( 64 位) | **1.0.10 ** | 54 | Android 6.0+ · arm64 | [Entryway-tv-release-1.0.10-arm64-v8a.apk ]( https://gitea.yamby.cn/yusheng/Entryway_Release/releases/download/android-tv-v1.0.10/Entryway-tv-release-1.0.10-arm64-v8a.apk ) | [ 下载 ]( https://github.com/YuSheng-Jack/Entryway_Release/releases/download/android-tv-v1.0.10/Entryway-tv-release-1.0.10-arm64-v8a .apk ) |
| Android TV( 32 位) | **1.0.10 ** | 54 | Android 6.0+ · armeabi-v7a | [Entryway-tv-release-1.0.10-armeabi-v7a.apk ](https://gitea.yamby.cn/yusheng/Entryway_Release/releases/download/android-tv-v1.0.10/Entryway-tv-release-1.0.10-armeabi-v7a.apk ) | [ 下载 ]( https://github.com/YuSheng-Jack/Entryway_Release/releases/download/android-tv-v1.0.10/Entryway-tv-release-1.0.10-armeabi-v7a.apk ) |
| Windows x64 | 开发中 | — | Windows 10/11 | 独立版待发布 | — |
> Android 手机版从 0.24.0 起使用 Preview 持续发布构建:启用 R8、AOT 与 Baseline Profile,但仍沿用 1.0 前公开包的调试证书,可直接覆盖安装;TV 继续使用 Debug 构建,Windows 安装包未签名。Preview/Debug 均不是正式 Release 构建。
>
> ⚠️ v0.19.0 的手机安装包误用了正式发布证书,无法覆盖安装。0.18.x 及更早版本可直接覆盖安装 0.20.0;若已安装 v0.19.0,需先卸载再安装。
>
> Windows 端正在重构,预计 **2026 年 8 月 17 日**正式发布新版。
| 安装包 | 大小 | SHA-256 |
| --- | ---: | --- |
| `entryway-release-1.0.11-arm64-v8a.apk` | 59,303,528 B | `0e9c8dfdbf3afd22e171317340745390b793a2615d29935aea9a786ffd218efe` |
| `Entryway-tv-release-1.0.10-arm64-v8a.apk` | 55,215,923 B | `4cb57bacbcca4fc990858b1b6834029419d2bfad277c47f7170b6138b4e0b522` |
| `Entryway-tv-release-1.0.10-armeabi-v7a.apk` | 48,749,629 B | `56c01e553e724cffb5541fdeee3591d3a0b70dda133e59c6f8d9375e2d394ef3` |
- **变更日志**: [ `RELEASE_NOTES.md` ](RELEASE_NOTES.md )
- **全部版本**: [ Gitea Releases ]( https://gitea.yamby.cn/yusheng/Entryway_Release/releases ) | [ GitHub Releases ]( https://github.com/JackYucongjia/Entryway_Release/releases )
- 安装包均为 Release 构建,使用正式密钥签名(证书 SHA-256 `a027e7a59bb3931250385e1ba44bd049a9dca9a855101e3263d617b3919b7bcc` )。
- **TV 该下哪个包**:大多数电视、投影仪、盒子用 64 位包;安装时提示「解析错误」「与设备不兼容」的老设备,改用 32 位包。应用内更新会按已装的包自动选择。
- **从 1.0 之前的 Preview 版升级**:签名不同,不能直接覆盖。请先在「设置 › 备份与恢复」备份到本地文件或 WebDAV,卸载旧版、安装新版后再恢复。已装 1.0.1 及以后版本的,在应用内检查更新即可。
- 每个版本的更新内容见对应 Release 说明:[Gitea Releases ](https://gitea.yamby.cn/yusheng/Entryway_Release/releases ) | [GitHub Releases ](https://github.com/YuSheng-Jack/Entryway_Release/releases )。`RELEASE_NOTES.md` 仅保留 v0.24.0 及更早的合并发布记录。
## 概述 | Overview
手机版 1.0.11:修复 mpv 续播点与账本内核标记、音乐倍速计时;增强一键诊断、账号/备份保护、Trakt 与播放体验。TV 保持 1.0.10,真实 NAS 与特定片源兼容性仍待验证。Entryway 永久免费。
**Entryway ** 是一个面向自建媒体服务器用户的跨平台客户端,覆盖 **Android 手机 ** 、**Android TV** 和 **Windows ** 三端。核心设计理念是 **多服务器聚合 ** ——在一个统一的界面中管理和浏览你所有的 Jellyfin / Emby 服务器 。
1.0.10:新增 Mine 影音与音乐账本、年度报告与票根;完善 FN Connect 动态连接、服务器编辑与跨端配置;手机版加入自定义组件与合集封面,TV 改善字号、Hero、网格、媒体库排序和壁纸。两端新增动态开屏和片尾式致谢。完整内容见[ 手机更新说明 ]( https://gitea.yamby.cn/yusheng/Entryway_Release/releases/tag/android-phone-v1.0.10 )与 [ TV 更新说明 ]( https://gitea.yamby.cn/yusheng/Entryway_Release/releases/tag/android-tv-v1.0.10 ) 。
Entryway is a cross-platform client for self-hosted media server users, available on **Android Mobile ** , **Android TV ** , and **Windows ** . Its core philosophy is **multi-server aggregation ** — managing and browsing all your Jellyfin / Emby servers from a single, unified interface.
## 交流群 | Community
**官网 ** : [www.yamby.cn ](https://www.yamby.cn )
欢迎加入 QQ 用户群 **Entryway Buddys ** (群号 **1107768156 ** ):反馈问题、交流服务器与播放设置,新版本的消息也会第一时间在群里发布。
## 核心特性 | Features
Join the **Entryway Buddys ** QQ group (number **1107768156 ** ) for feedback, tips and release news.
### 🖥️ 多服务器管理
- 添加多个 Jellyfin / Emby 服务器,一键快速切换
- 服务器卡片显示用户头像、用户名、服务器地址
- 私密服务器:标记后默认隐藏,需手动开启显示
- 冷启动离线恢复:服务器不可用时不清除账号
<p align="center">
<img src="community-qq.png" alt="QQ 群 Entryway Buddys 入群二维码" width="260">
</p>
### 🎬 双引擎播放器(Android)
- **ExoPlayer**:默认引擎,基于 Media3 + FFmpeg 扩展
- **mpv**:高兼容性引擎,含 libdvdread/libdvdnav/libbluray
- 自动容错切换,保留播放进度
- 解码模式:SW / HW / HW+ / DV-SW
> 用 QQ「扫一扫」扫码,或在 QQ 里搜索群号加入。官网 [entryway.top](https://entryway.top/#community) 上也有同一张二维码;手机版、TV 版的「设置 › 关于 › QQ 交流群」里也能找到。
### 💬 多弹幕服务
- 弹弹Play 官方、LogVar 弹幕 API、其他弹弹Play 兼容服务
- 按优先级有序故障回退,数据源严格隔离
- 自动匹配、手动搜索、本地弹幕、LRU 缓存
- 三端支持(手机 / TV / Windows)
## 支持的媒体源 | Sources
### 💿 实验性 DVD / Blu-ray ISO
- 未加密原盘本地与远程播放
- 不支持时自动回退服务器转码
### 📺 Android TV
- 遥控器全键盘搜索、二维码手机输入
- 完整弹幕、扫码录入服务器、首页缓存兜底
### 🪟 Windows
- Flutter + MediaKit (libmpv) + Rust 弹幕引擎
- 多服务器、收藏、详情、跨服搜索、离线下载
- Chromecast/DLNA 投屏、Inno Setup 安装器
### 🎨 设计与国际化
- 空间化 / 玻璃态视觉语言,Material 3 动态配色
- 完整中文(简体/繁体)和英文本地化
### 📥 离线下载
- 队列化管理,批量下载,存储空间预估
- 无网络时自动切换离线内容模式
## 平台要求 | Requirements
| 平台 | 最低要求 |
| 类型 | 支持 |
| --- | --- |
| Android 手机版 | Android 8.1 (API 27) |
| Android TV 版 | Android 8.1 (API 27) |
| Windows | Windows 10 x64 |
| 视频服务器 | Emby 及兼容服务端、Jellyfin、Plex、飞牛影视(fnOS)、极影视 |
| 音乐服务器 | Navidrome、Subsonic 兼容服务、极音乐、飞牛音乐 |
| 直播与点播 | IPTV( M3U / TXT 频道表,XMLTV 节目单)、点播 CMS(苹果 CMS v10 接口、TVBox 配置) |
| 文件源 | 本地文件夹、SMB、WebDAV / Alist、U 盘(TV) |
| 网盘 | 夸克、115、天翼云盘、中国移动云盘、联通云盘、光鸭云盘、CloudDrive2 |
| 弹幕 | 弹弹Play 官方、LogVar 弹幕 API 及其他弹弹Play 兼容服务 |
## 能做什么 | Highlights
### 手机版 1.0.10
- **Mine 与音乐账本**:实际观看/收听时长、热力图、历史筛选、年度报告、影音与黑胶票根;音乐按实际播放输出计时。
- **FN Connect**:保存 FN ID 原入å