Welcome to EmbyTok
EmbyTok is a modern vertical video browser designed for media servers, bringing a TikTok-style browsing experience to your personal media library. Swipe through your videos with an intuitive, mobile-first interface that makes consuming your media collection feel fresh and engaging.Key Features
TikTok-Style Browsing
Full-screen vertical video browsing with swipe gestures to navigate between videos
Multi-Server Support
Works with Emby, Jellyfin, Plex, local folders, and LAN file servers
Smart Video Filtering
Filter videos by orientation (vertical, horizontal, or both) to match your viewing preference
Favorites & Playlists
Like and save your favorite videos with automatic playlist management
Multiple Browse Modes
Choose from Latest, Random, or Favorites feeds to discover content
Adaptive Layout
Seamlessly switch between feed view and grid view for different browsing experiences
Auto-Play Mode
Continuous playback with a clean, distraction-free interface
Cross-Platform
Available as a web app, PWA, Android app (via Capacitor), and native iOS app (UIKit)
Browse Modes
EmbyTok offers three ways to explore your media:- Latest: Browse videos sorted by date added (newest first) with infinite scrolling
- Random: Discover content with randomized recommendations
- Favorites: Access your liked videos in one place
Multi-Server Architecture
EmbyTok supports multiple backend options:Emby & Jellyfin
Native integration with Emby and Jellyfin media servers using their REST APIs
Plex
Connect to Plex servers using X-Plex-Token authentication
Local Folders
Browse videos directly from your device’s file system (browser-based)
LAN File Server
Self-hosted file server mode for sharing videos across your local network
Technology Stack
Built with modern web technologies:- React 18 with TypeScript for type-safe development
- Vite for lightning-fast builds and hot module replacement
- Tailwind CSS for responsive, utility-first styling
- Capacitor for building native Android apps
- UIKit + AVFoundation for native iOS playback
- Docker with multi-architecture support (AMD64/ARM64)
Core Implementation
EmbyTok uses a client factory pattern to support multiple server types. Here’s how it authenticates:components/Login.tsx
Orientation-Aware Filtering
EmbyTok intelligently filters videos based on aspect ratio:services/EmbyClient.ts
Video Prefetching
For smooth playback, EmbyTok prefetches upcoming videos:components/VideoFeed.tsx
Get Started
Quickstart Guide
Get up and running with EmbyTok in 5 minutes
Docker Deployment
Deploy EmbyTok on your NAS or server with Docker
iOS Native App
Build and install the native iOS app with UIKit
Configuration
Configure server connections and customize your experience
EmbyTok is an unofficial client and is not affiliated with Emby, Jellyfin, or Plex. Please ensure you comply with your local laws and regulations when using this software.