juneix
100 lines
2.7 KiB
Markdown
100 lines
2.7 KiB
Markdown
# 📱 EmbyX Vertical Player `v1.1`
|
|
|
|
[中文说明](./README_zh.md) | [English Documentation](./README.md)
|
|
|
|
> A TikTok-style web interface for Emby / Jellyfin, designed for browsing and managing short videos in an immersive way.
|
|
|
|
---
|
|
|
|
## ✨ Features
|
|
|
|
- **Fluid Playback**: TikTok-style vertical scrolling, immersive full-screen experience.
|
|
- **Grid View**: Browse with cover walls, supports pagination and random refresh.
|
|
- **Direct Play**: Works natively on modern devices. Support for 8K, AV1, and HEVC without transcoding.
|
|
- **Library Sync**: One-tap to favorite/unfavorite videos, fully synced with Emby server.
|
|
- **Key & Mouse Support**: Complete keyboard shortcut mapping. Friendly for TV and PC browsers.
|
|
- **PWA Ready**: Install as a desktop or home screen app.
|
|
- **Privacy First**: All data is stored locally; nothing is uploaded to the cloud.
|
|
|
|
---
|
|
|
|
## 🔮 Playback Performance
|
|
|
|
| Device | HEVC Decode | AV1 Decode |
|
|
|:---:|:---:|:---:|
|
|
| Apple | A9 (2015) / M1 | A17 Pro (2023) / M3 |
|
|
| Android | Budget (2016) | Budget (2024) |
|
|
| PC | Intel Core 6-8th Gen (iGPU) | Intel Core 11th Gen+ (iGPU) |
|
|
|
|
---
|
|
|
|
## ⌨️ Shortcuts Guide
|
|
|
|
| Key | Function |
|
|
|:---:|---|
|
|
| `W / S / ↑ / ↓` | Previous / Next Video |
|
|
| `A / D / ← / →` | Seek Back / Forward 15s |
|
|
| `Space / Click OK` | Pause / Play |
|
|
| `U / Double Click OK` | Favorite Video |
|
|
| `J / Menu Key` | Toggle Aspect Ratio |
|
|
| `M` | Toggle Mute |
|
|
| `I` | Open Settings / Profile |
|
|
| `E` | Toggle View Mode (List/Grid) |
|
|
| `R` | Sequential / Random Mode |
|
|
| `F` | Fullscreen Mode |
|
|
| `G` | Toggle Libraries |
|
|
| `V` | Show File Info |
|
|
|
|
---
|
|
|
|
## 📁 Directory Structure
|
|
|
|
```
|
|
embyx/
|
|
├── zh/ # Chinese Version
|
|
│ ├── index.html
|
|
│ ├── manifest.json
|
|
│ └── ...
|
|
├── en/ # English Version
|
|
│ ├── index.html
|
|
│ ├── manifest.json
|
|
│ └── ...
|
|
├── README.md # English (Default)
|
|
└── README_zh.md # Chinese
|
|
```
|
|
|
|
---
|
|
|
|
## 🚀 Deployment
|
|
|
|
### Option 1: Direct File Hosting (Recommended)
|
|
|
|
Simply put all files from either `zh/` or `en/` folder into your web server (Nginx, Apache, etc.).
|
|
|
|
### Option 2: Docker Deployment
|
|
|
|
One image, multiple languages. Controlled by environment variable.
|
|
|
|
```bash
|
|
docker run -d \
|
|
--name embyx \
|
|
--network host \
|
|
-e APP_LANG=en \
|
|
-e APP_PORT=8090 \
|
|
ghcr.io/juneix/embyx:latest
|
|
```
|
|
|
|
| Env | Description | Default |
|
|
|---|---|---|
|
|
| `APP_LANG` | `en` (English) / `zh` (Chinese) | `en` |
|
|
| `APP_PORT` | The port the container will listen on | `8090` |
|
|
|
|
---
|
|
|
|
## 📝 License
|
|
|
|
MIT License — Feel free to use, PRs and Issues are welcome.
|
|
|
|
👨🏻💻 Author: [@Juneix](https://juneix.github.io)
|
|
🛜 Official Site: [June's Hub](https://5nav.eu.org)
|