embyx/README_zh.md

📱 EmbyX 竖屏播放器 v1.1

这是一个技术小白借助 Antigravity 和 Emby API 制作的 Web 应用，仿抖音风格浏览、管理 Emby 的短视频。

---

✨ 功能特色

• 流式播放：抖音风格上下滑动，沉浸式全屏体验
• 格子视图：封面墙浏览，支持分页与随机换一批
• 直接播放（Direct Play）：安卓 AV1、8K 不转码
• 收藏管理：一键收藏 / 取消，同步 Emby 数据库
• 键鼠适配：完整键盘快捷键，电视/电脑浏览器友好
• PWA 支持：可安装为桌面/主屏幕应用
• 私有化部署：数据本地存储，不上传云端

---

🔮 播放性能

设备	HEVC 硬解	AV1 硬解
苹果	A9 (2015) / M1	A17 Pro (2023) / M3
安卓	千元机 (2016)	千元机 (2024)
PC	6～8 代酷睿·核显	11 代酷睿·核显

---

⌨️ 快捷键指南

按键	功能
W / S / ↑ / ↓	上一个 / 下一个视频
A / D / ← / →	快退 / 快进 15 秒
Space / 单击 OK	暂停 / 播放
U / 双击 OK	收藏视频
J / 菜单键	比例切换
M	音量开关
I	个人中心
E	视图切换
R	顺序 / 随机
F	全屏切换
G	选择媒体源
V	流媒体详情

---

🧩 使用技巧

• 原生全屏：iOS 系统限制，不支持全屏按钮
• PWA 应用：浏览器 📲 添加到主屏幕 / 作为应用安装
• 键鼠适配：电脑、电视浏览器也能快乐摸鱼
• 媒体库建议：单个媒体库建议不超过 1000 个视频，可建立多个媒体库分层管理

---

🛠️ 技术栈

层级	技术
结构	HTML5 语义化标签
样式	Tailwind CSS（CDN，JIT 按需）
逻辑	原生 JavaScript（无框架）
图标	Lucide Icons（CDN）
数据	Emby REST API
离线支持	Service Worker（PWA）
容器	Nginx Alpine（Docker 部署时）

---

📁 文件目录

embyx/
├── index.html        # 核心文件，包含所有逻辑与样式
├── poster.webp       # 自定义默认封面图（可替换）
├── manifest.json     # PWA 配置文件
├── sw.js             # Service Worker（离线缓存）
├── icon.png          # PWA 图标
├── Dockerfile        # Docker 镜像构建文件
└── docker-compose.yml  # 一键部署配置

---

🚀 部署方式

方式一：直接部署（推荐个人用户）

将以下文件放入任意 Web 服务器（Nginx、Apache、NAS 静态服务等）根目录：

index.html
poster.webp
manifest.json
sw.js
icon.png

尝鲜玩法：手机可以直接双击 index.html（file:// 协议）本地使用，通过 HTTP 访问 Emby。

---

方式二：Docker 部署

使用 Docker

# 拉取最新镜像
docker pull ghcr.io/juneix/embyx:latest

# 运行容器（映射到本机 8080 端口）
docker run -d \
  --name embyx \
  --network host \
  -e APP_LANG=zh \
  -e APP_PORT=8090 \
  --restart unless-stopped \
  ghcr.io/juneix/embyx:latest

访问 http://your-server-ip:8080 即可使用。

使用 docker-compose（推荐）

# 下载 docker-compose.yml 后执行
docker compose up -d

或者直接复制到群晖、飞牛、Dockge 的 docker-compose 模板：

services:
  embyx:
    image: ghcr.io/juneix/embyx:latest
    container_name: embyx
    restart: unless-stopped
    network_mode: host
    environment:
      - APP_LANG=zh # zh (中文), en (英文)
      - APP_PORT=8090 # 在 host 模式下，直接定义访问端口

---

📝 开源协议

MIT License — 随意使用，欢迎 PR 和 Issue。

👨🏻‍💻 作者：@谢週五
🛜 官网：谢週五の藏经阁