https://github.com/juneix/embyx
Watch Emby short videos like Tiktok. 像刷抖音一样看 Emby 短视频。
https://github.com/juneix/embyx
docker emby emby-client jellyfin jellyfin-client nas self-hosted tiktok web-app
Last synced: 2 months ago
JSON representation
Watch Emby short videos like Tiktok. 像刷抖音一样看 Emby 短视频。
- Host: GitHub
- URL: https://github.com/juneix/embyx
- Owner: juneix
- License: mit
- Created: 2025-11-20T08:43:33.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-04-17T04:09:28.000Z (3 months ago)
- Last Synced: 2026-04-17T04:36:16.076Z (3 months ago)
- Topics: docker, emby, emby-client, jellyfin, jellyfin-client, nas, self-hosted, tiktok, web-app
- Language: HTML
- Homepage: https://embyx.5nav.eu.org
- Size: 1.22 MB
- Stars: 36
- Watchers: 0
- Forks: 8
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 📱 EmbyX
[中文说明](./README_zh.md)
[](https://github.com/juneix/embyx/releases)
[](https://github.com/juneix/embyx/stargazers)
[](https://github.com/juneix/embyx/forks)
[](https://hub.docker.com/r/juneix/embyx)
[](./LICENSE)
[](https://github.com/juneix/embyx)
A TikTok-style web player for Emby / Jellyfin. Experience your private media library in a whole new, immersive way. 🎉
## ✨ Features
- **Fluid Playback**: TikTok-style vertical scrolling for an **immersive** experience.
- **Direct Play**: Up to **8K HEVC / AV1** on Android—no transcoding.
- **Poster Wall**: Elegant album view with pagination and **shuffle**.
- **Emby Sync**: Real-time sync for **libraries, playlists, and favorites**.
- **Desktop Friendly**: Optimized for **keyboard & mouse**, Perfect for TV and PC.
- **PWA Ready**: Install as a **standalone** app on your home screen or desktop.
- **Privacy First**: All data stays **on your device**, no cloud uploads.
## 💡 Get Started
Try EmbyX instantly via the official web app:
- 🌐 **Main Site** - [embyx.5nav.eu.org](https://embyx.5nav.eu.org)
- ⚡ **Mirror Site** - [embyx.5nav.pp.ua](https://embyx.5nav.pp.ua)
Prefer full control? You can **self-host** EmbyX on your own server.
## 📢 Spread the Word
If EmbyX makes your digital life easier, please `star it on GitHub ⭐️`, or share it with your friends and the community! As an independent developer, your support is the best way to help this project grow.
> Love it? [Donations are welcome!](#❤️-support-the-project)
## 🔮 Playback Performance
| Device | HEVC Decode | AV1 Decode |
|:---:|:---:|:---:|
| Apple | A9 (2015) / M1 | A17 Pro (2023) / M3 |
| Android | Budget Phones (2016) | Budget Phones (2024) |
| PC | Intel 6-8th Gen iGPU | Intel 11th Gen+ iGPU |
## ⌨️ Shortcuts Guide
| Key | Function |
|:---:|---|
| `W / S / ↑ / ↓` | Prev / Next Video |
| `A / D / ← / →` | Rewind / Forward 15s |
| `Space / Click OK` | Pause / Play |
| `U / Double Click OK` | Favorite Video |
| `J / Menu Key` | Toggle Aspect Ratio |
| `M` | Toggle Mute |
| `I` | Profile |
| `E` | Toggle View |
| `R` | Sequential / Random |
| `F` | Toggle Fullscreen |
| `G` | Select Libraries |
| `V` | Media Info |
## 📁 Directory Structure
```
embyx/
├── zh/ # Chinese Version
├── en/ # English Version
├── README.md # English Documentation (Default)
├── README_zh.md # Chinese Documentation
├── Dockerfile # Docker Image Build File
├── docker-compose.yml # Docker Compose Configuration
├── entrypoint.sh # Docker Entrypoint
└── nginx.conf # Nginx configuration
```
## 🚀 Deployment
### Option 1: Direct File Hosting (Recommended)
Simply put all files from `en/` folder into your web server (Nginx, Apache, etc.)
### Option 2: Docker Deployment
Don't want to mess with the environment? Just use Docker. Recommended GHCR for updates, Docker Hub for NAS.
- GHCR: `ghcr.io/juneix/embyx`
- Docker Hub: `juneix/embyx`
#### Docker CLI:
```bash
docker run -d \
--name embyx \
--network host \
-e APP_LANG=en \
-e APP_PORT=8090 \
ghcr.io/juneix/embyx
```
#### Docker Compose:
```yaml
services:
embyx:
image: ghcr.io/juneix/embyx
# image: juneix/embyx # Docker Hub Mirror
container_name: embyx
restart: unless-stopped
network_mode: host
environment:
- APP_LANG=en # English Version
- APP_PORT=8090 # Access Port
```
## ❤️ Support & Community
If you find EmbyX useful, consider supporting its development or joining our community. Your word-of-mouth and support help this project grow!
| Support | Community |
| :--- | :--- |
| [](https://ko-fi.com/juneixtse) | [](https://t.me/juneix_en) |
| [](https://paypal.me/juneixtse) | [](https://x.com/juneix_tse) |
## 🌟 Star History
[](https://star-history.com/#juneix/embyx&Date)
## 📝 License
MIT License — Feel free to use, PRs and Issues are welcome.