@@ -3,88 +3,104 @@
</p>
<p align="center"><strong>Entryway</strong></p>
<p align="center">多服务器聚合管理的 Android 媒体客户端，支持 Jellyfin 和 Emby。</p>
<p align="center">A multi-server aggregation Android media client for Jellyfin & Emby.</p>
<p align="center">多服务器聚合管理的跨平台 媒体客户端，支持 Jellyfin 和 Emby。</p>
<p align="center">A multi-server aggregation media client for Jellyfin & Emby — Android, Android TV & Windows .</p>
<p align="center"><a href="https://www.yamby.cn">官方网站 | Official Website</a></p>
<p align="center">
<img src="https://img.shields.io/badge/Platform-Android-3DDC84?style=flat-square&logo=android&logoColor=white" alt="Android ">
<img src="https://img.shields.io/badge/Kotlin-2.0-7F52FF?style=flat-square&logo=kotlin&logoColor=whit e" alt="Kotlin ">
<img src="https://img.shields.io/badge/Jetpack_Compose-Material_3-4285F4?style=flat-square&logo=jetpackcompose&logoColor=white" alt="Compose">
<img src="https://img.shields.io/badge/Min_SDK-27_(Android_8.1)-34A853?style=flat-square" alt="MinSDK">
<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-squar e" alt="Server ">
<img src="https://img.shields.io/badge/License-MIT-blue?style=flat-square" alt="License">
</p>
---
## 最新版本 | Latest Release
**全局标签 `v0.22.0` ** （各端应用版本独立；本批次为 Debug 持续发布）
| 平台 | 应用版本 | 构建号 | 下载 |
| --- | --- | --- | --- |
| Android 手机版 | 0.22.0 | 43 | [`entryway-debug-0.22.0.apk` ](https://gitea.yamby.cn/yusheng/Entryway_Release/releases/download/v0.22.0/entryway-debug-0.22.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.22.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.22.0/Entryway_0.18.0+37_Windows_x64_Setup.exe ) |
> Android 手机版与 TV 版沿用 1.0 前的调试证书签名约定，Windows 安装包未签名；首次运行可能触发系统安全提示，需手动确认。
>
> ⚠️ v0.19.0 的手机安装包误用了正式发布证书，无法覆盖安装。0.18.x 及更早版本可直接覆盖安装 0.20.0；若已安装 v0.19.0，需先卸载再安装。
- **变更日志**： `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 )
## 概述 | Overview
**Entryway ** 是一个面向自建媒体服务器用户的 Android 客户端， 核心设计理念是 **多服务器聚合 ** ——在一个统一的界面中管理和浏览你所有的 Jellyfin / Emby 服务器。
**Entryway ** 是一个面向自建媒体服务器用户的跨平台客户端，覆盖 **Android 手机 ** 、**Android TV** 和 **Windows ** 三端。 核心设计理念是 **多服务器聚合 ** ——在一个统一的界面中管理和浏览你所有的 Jellyfin / Emby 服务器。
Entryway is an Android client designed for self-hosted media server users. Its core philosophy is **multi-server aggregation ** — managing and browsing all your Jellyfin / Emby servers from a single, unified interface.
Entryway is a cross-platform client for self-hosted media server users, available on **Android Mobile ** , **Android TV ** , and **Windows ** **multi-server aggregation ** — managing and browsing all your Jellyfin / Emby servers from a single, unified interface.
**官网 ** ： www.yamby.cn ](https://www.yamby.cn )
## 核心特性 | Features
### 🖥️ 多服务器管理
- 添加多个 Jellyfin / Emby 服务器，一键快速切换
- 服务器卡片显示用户头像、用户名、服务器地址
- 长按菜单：重新登录、服务器线路、修改图标、修改备注、设为私密、修改密码、编辑、删除
- 溢出菜单：搜索、排序（默认/名称/最近使用）、网格/列表布局切换、显示选项
- 私密服务器：标记后默认隐藏，需手动开启显示
- 冷启动离线恢复：服务器不可用时不清除账号
### 🏠 首页即服务器
- 首页直接展示当前活跃服务器的媒体库内容
- 左上角显示当前服务器名，点击即可切换到其他非私密服务器
- 支持精选轮播（Featured Carousel）和无轮播两种模式
### 🎬 双引擎播放器（Android）
- **ExoPlayer**：默认引擎，基于 Media3 + FFmpeg 扩展
- **mpv**：高兼容性引擎，含 libdvdread/libdvdnav/libbluray
- 自动容错切换，保留播放进度
- 解码模式：SW / HW / HW+ / DV-SW
### 🎬 双引擎播放器
- **ExoPlayer 引擎**：默认播放引擎，基于 Media3 + Jellyfin FFmpeg 扩展
- **mpv 引擎**：备用高兼容性引擎，基于 libmpv，支持更多编解码格式
- 播放失败时自动提供引擎切换建议，支持手动一键切换
- 切换引擎时自动保持播放进度
- 统一 User-Agent： `Entryway/{version} (android; {api})`
### 💬 多弹幕服务
- 弹弹Play 官方、LogVar 弹幕 API、其他弹弹Play 兼容服务
- 按优先级有序故障回退，数据源严格隔离
- 自动匹配、手动搜索、本地弹幕、LRU 缓存
- 三端支持（手机 / TV / Windows）
### ⏩ 播放控制
- **倍速播放**： ）
- **长按快速倍速**：长按屏幕进入手动短时间高速播放
- **手势控制**：左右滑动快进快退、左侧上下滑动调亮度、右侧上下滑动调音量
- **画面比例**：循环切换适应/填充/16:9/4:3 等比例模式
- **锁屏**：锁定控制界面，防止误触
- **剧集导航**：上一集/下一集，播放列表（仅剧集）
### 💿 实验性 DVD / Blu-ray ISO
- 未加密原盘本地与远程播放
- 不支持时自动回退服务器转码
### 🔧 mpv 引擎专属
- **解码模式切换**：SW（软解）/ HW（硬解）/ HW+（硬解+拷贝）一键循环切换
- 字体自动加载，支持字幕渲染
### 📺 Android TV
- 遥控器全键盘搜索、二维码手机输入
- 完整弹幕、扫码录入服务器、首页缓存兜底
### 🔊 高级音频
- Apple Spatial Audio 空间音频检测与启用
- HDR / Dolby Vision 能力检测与自动适配
### 🪟 Windows
- Flutter + MediaKit (libmpv) + Rust 弹幕引擎
- 多服务器、收藏、详情、跨服搜索、离线下载
- Chromecast/DLNA 投屏、Inno Setup 安装器
### 🎨 全局主题系统
- 支持 **跟随系统 ** / **浅色 ** / **深色 ** 三种主题模式
- 基于 Material 3 动态配色方案
### 🌐 完整国际化
- 界面支持中文（简体/繁体）和英文
- 50+ 影视类型名称客户端翻译
- 根据系统语言自动切换
### 🎨 设计与国际化
- 空间化 / 玻璃态视觉语言，Material 3 动态配色
- 完整中文（简体/繁体）和英文本地化
### 📥 离线下载
- 队列化下载 管理，支持暂停/恢复/取消
- 季度/剧集批量下载，下载前显示存储空间预估
- 无网络时自动切换到离线内容模式
- 队列化管理，批量下载，存储空间预估
- 无网络时自动切换离线内容模式
## 技术栈 | Tech Stack
## 平台要求 | Requirements
| 类别 | 技术 |
|------|--- ---|
| **语言 ** | Kotlin 2.0, Coroutines, Flow |
| **UI ** | Jetpack Compose + Material 3 + Navigation Compose |
| **网络 ** | Retrofit 3 + OkHttp 5 |
| **图片 ** | Coil 3 |
| **播放器 ** | Media3 ExoPlayer + FFmpeg 扩展 / libmpv (双引擎) |
| **存储 ** | SharedPreferences + DataStore |
| **构建 ** | Gradle 9.4, AGP, KSP |
| 平台 | 最低要求 |
| --- | --- |
| Android 手机版 | Android 8.1 (API 27) |
| Android TV 版 | Android 8.1 (API 27) |
| Windows | Windows 10 x64 |
## 贡献 | Contributing
## 更新检测 | Update Check
欢迎提交 Issue 和 Pull Request。较大的功能开发建议先开 Issue 讨论范围 。
客户端内置更新检测，优先从 Gitea 获取最新版本，连接失败时自动降级到 GitHub 。
## 源码仓库 | Source Code
- **GitHub**： github.com/JackYucongjia/Entryway ](https://github.com/JackYucongjia/Entryway )
- **Gitea**： gitea.yamby.cn/yusheng/Entryway ](https://gitea.yamby.cn/yusheng/Entryway )
## 许可证 | License
本项目基于 MIT 许可证开源。
手机端弹幕实现参考了 MIT 许可的 [AimesSoft/NipaPlay-Reload ](https://github.com/AimesSoft/NipaPlay-Reload )。
Windows 客户端基于 NipaPlay-Reload `v1.10.13` 构建，保留上游 MIT 许可。
余生
余生