ynoTV

A feature-rich, open source IPTV player for Windows built on Tauri v2 and mpv.

Documentation

Video Demonstration

---

Screenshots:

EPG with preview	Play screen
Channel Overlay	EPG Editor
Watchlist Option with autoswitch	Calendar View
Sports View	Vod Page
Multiview Menu	PiP View
Multiview 2x2	DVR Page
Themes	Add Source

---

Features

• M3U, Xtream Codes & Stalker Support - multiple EPG sources supported
• Stremio Addons support - Integrated stremio addons support
• Grid-style EPG - with an integrated preview window
• Catchup & Cache Time Shift - instant replays on supported channels
• Automatic Stream Fallback - detects and switches away from stalled or dead streams
• Sports Tab - real-time scores and detailed game stats with instant search to find channel
• Cast to TV - Cast to any supported TV devices on your local network
• Trakt integration - Scrobble directly to your Trakt account
• Widget System - Display live sports score in overlay
• VOD Support - rich metadata via TMDB and RPDB with saved progress
• Subtitle Integration - Subsource support for VODs
• Popout Player & External player - play streams in a seperate MPV window or your choice in an external player
• Backup DNS/URLs - automatically swaps when the current source fails
• Favorites & Custom Groups - pull from any source
• Channel Management - rename, hide, and sort categories and channels freely
• EPG Editor - change tvg-id, logos, or auto-match to a different entry
• Embedded MPV Playback - with support for custom parameters
• Multiview - resizable PiP, also supporting up to four simultaneous streams in a 2x2 grid
• Channel & EPG Search - instant results with advanced filtering options
• Watchlist & Reminders - auto-swaps to a channel when a program goes live
• Built-in DVR - record any stream or schedule for later
• TV Calendar - powered by TVMaze for auto-setting reminders on upcoming shows
• Reprogrammable Hotkeys - fast navigation
• 40+ Built-in Themes - something for every preference

---

Building from Source

Building from Source

Prerequisites

• Node.js 20.x or higher
• pnpm 9.x or higher — install with npm install -g pnpm (the project specifies 9.1.0 via the packageManager field; if you have corepack enabled, the correct version is used automatically)
• Rust (latest stable) — required for the Tauri backend. Install via rustup
• Git

Windows additional requirements:

• Microsoft Edge WebView2 — required for Tauri's rendering engine
• Visual Studio 2022 with C++ build tools
• Windows 10 SDK

Instructions

1. Clone the repository

git clone https://github.com/tbeezy/ynotv.git
cd ynotv

2. Install dependencies

pnpm install

3. Download mpv sidecar

FFmpeg is downloaded automatically during the build step, but mpv (and yt-dlp) must be downloaded manually first:

bash scripts/download-mpv-tauri.sh

(Optional) If you also want to pre-download FFmpeg manually:

cd packages/app
node scripts/download-ffmpeg.js
cd ../..

4. Run in development mode

pnpm dev

This starts both the Vite UI dev server and the Tauri app concurrently.

5. Build for production

pnpm tauri build

Build output is located at:

packages/app/src-tauri/target/release/bundle/

---

Data & File Locations

Data & File Locations

Configuration

%APPDATA%\com.ynotv.app\
├── settings.json          # Sources, shortcuts, and preferences
└── .windows-state.json    # Window size and position

Database (SQLite)

%LOCALAPPDATA%\com.ynotv.app\app.db

The database stores channels, categories, EPG programs (7-day window), VOD movies and series, watchlist entries, reminders, DVR schedules and recordings, channel metadata, and source sync timestamps.

Logs

Debug logging can be enabled in Settings > Debug. Log output is written to:

%APPDATA%\com.ynotv.app\logs\app.log

DVR Recordings

The recording directory is configurable in Settings > DVR. The default location is:

%USERPROFILE%\Videos\ynoTV Recordings\

---

Keyboard Shortcuts

Keyboard Shortcuts

All shortcuts are fully customizable in Settings > Shortcuts.

Playback

Action	Default
Play / Pause	Space
Seek Forward	Right Arrow
Seek Backward	Left Arrow
Mute / Unmute	M
Select Subtitle (Modal)	J
Select Audio Track (Modal)	A
Toggle Fullscreen	F
Replay Last Stream	Q

Navigation

Action	Default
Channel Up	Up Arrow
Channel Down	Down Arrow

Interface

Action	Default
Toggle Live TV (Guide + Categories)	L
Toggle Guide	G
Toggle Categories	C
Toggle DVR	R
Toggle Sports	U
Toggle TV Calendar	T
Toggle Settings	,
Show / Hide Stats	I
Focus Search	S
Toggle EPG View Layout	E
Close / Back	Esc

Layout

Action	Default
Layout: Main View	1
Layout: Picture in Picture	2
Layout: Big + Bottom Bar	3
Layout: 2×2 Grid	4

---

Star History

---

Disclaimer

Built with the help of AI.

ynoTV is a media player only. It does not provide, host, distribute, or facilitate access to any streaming services, broadcast content, channel lists, or IPTV subscriptions of any kind.

All content, streams, and playlists are sourced, configured, and managed solely by the end user. The developers have no knowledge of, control over, or responsibility for any third-party content accessed through the application.

Users are solely responsible for ensuring that any content they access complies with the laws and regulations applicable in their jurisdiction. The developers do not condone or support the use of this application to access unlicensed or unauthorized content.

Metadata displayed within the application is sourced from publicly available third-party databases including TVMaze and TMDB. ynoTV does not claim ownership of this metadata.

---

Credits

ynoTV builds on the following open source projects and services:

• sbtlTV — original foundation
• Tauri — desktop application framework
• mpv — video playback engine
• FFmpeg — recording and thumbnail generation
• TVMaze — TV schedule and show metadata
• TMDB — movie and series metadata
• MY-1 Mac Stalker Player - Stalker integration

---

License

GNU Affero General Public License v3.0