ON AIR  ·  IPTV PLAYER · DVR · EPG

Your TV. RetroTV

A free, open-source desktop IPTV player with a retro CRT interface. Bring your own streams and playlists — M3U, M3U8, XSPF, or local folders. Watch live with EPG schedules, record with DVR, schedule recordings, build your own channels, shuffle your own media with commercial breaks, and enjoy authentic channel-surfing vibes. No subscription. No login. No tracking.

Setup Wizard Channel Builder M3U Import Fullscreen Overlay Settings Panel DVR Recording Scheduled Recordings Sleep Timer Channel Surfing EPG Guide No Account Commercial Breaks Resume Support ★ Favorites M3U / XSPF / Folders CC Subtitles Recently Watched Windows · Mac · Linux
Features

Your Streams. Your Rules.

RetroTV is a free, open-source desktop IPTV player and media centre. Add any live stream URL, import M3U/M3U8 playlists, load XSPF files, or point it at a folder of videos. Built on VLC, it plays every modern format without fuss — wrapped in a phosphor-amber CRT interface with EPG guide, DVR recording, scheduled recordings, channel builder, commercial break simulation, sleep timer, and more.

🧙

Setup Wizard v2.0

Brand-new first-run experience. Choose curated channels from N5 Networks, import your own M3U/M3U8 playlist from a file or URL, and optionally add an EPG source — all before you even see the main screen.

🔧

Channel Builder v2.0

Build custom channels from video files on your computer. Add files or entire folders, drag to reorder, toggle shuffle and commercial breaks — then save as an M3U playlist that RetroTV loads automatically.

⬇️

M3U Playlist Import v2.0

Import channels directly from local or remote M3U/M3U8 playlists. Enter a URL or browse for a file — channel names, stream URLs, and EPG IDs are parsed automatically and added to your lineup.

⚙️

Settings Panel v2.0

Full settings dialog: configure commercial break counts, EPG refresh interval, 24-hour clock, hardware acceleration, network buffer size, startup behaviour, always-on-top, screensaver suppression, and curated channel syncing.

🖥️

Fullscreen Overlay v2.0

Mouse-triggered control overlay in fullscreen. Move your cursor to reveal seek bar, transport controls, volume slider, channel navigation, EPG toggle, and exit — all floating above the video. Auto-hides after 3 seconds of inactivity.

🖱️

EPG Click-to-Record v2.0

Click any programme cell in the EPG guide to see a detail popup with title, time, category, and description. One-click "Schedule Recording" sets up a DVR capture that starts and stops automatically at the right times.

📅

Manual DVR Scheduling v2.0

No EPG data? No problem. Open the DVR Schedule Manager and manually set a recording by picking a channel, date, start time, and stop time. RetroTV arms a background timer and starts ffmpeg when the moment arrives.

🧊

Stream Freeze Detection v2.0

8-second watchdog monitors live stream playhead movement. If the stream freezes, RetroTV automatically reconnects with a 10-second safety deadline to prevent infinite retry loops — so you spend less time staring at a frozen frame.

📹

Guide Livestream Preview v2.0

Channel 00 now features a split-screen layout: the bottom two-thirds shows the full EPG grid, while the top third displays a live video preview window playing a random channel from your lineup — complete with channel name and click-to-tune.

🏷️

EPG Channel Icons v2.0

Network logos from XMLTV data are automatically fetched and displayed in the EPG guide grid. Icons load in the background and cache in memory, so the guide stays responsive even with hundreds of channels.

🔴

DVR Recording NEW

Hit ● REC (or press R) to record any live stream in real time. Recordings are saved as .ts files you can play back inside RetroTV or in any video player. ffmpeg is included with the Windows installer.

📼

Recordings Library NEW

Browse, play, and delete your DVR recordings from the built-in library manager. Play recordings directly inside RetroTV with full pause and seek support.

Sleep Timer NEW

Set an auto-shutdown timer from 15 to 120 minutes (or enter a custom duration). If a DVR recording is active when the timer fires, RetroTV mutes and minimizes instead of closing — so your scheduled captures finish cleanly.

🎲

Channel Surfing NEW

Hit 🎲 SURF to jump to a random channel — automatically avoiding your recently watched stations for a true channel-surfing experience. Never know what's coming next.

Recently Watched NEW

Your last 10 watched channels are remembered across sessions. Filter the sidebar with ◷ HIST to quickly jump back to stations you were just watching.

📰

Live EPG Program Guide

Powered by XMLTV data, Channel 00 displays a full-screen electronic program guide with channel icons, now/next indicators, progress bars, and a live video preview. See what's on and what's coming up at a glance.

🎞️

Commercial Break Simulator

Recreate the authentic broadcast experience. Place video files in your commercials/ folder or use a commercials.xspf playlist, and RetroTV will automatically insert nostalgic ad breaks between your local tracks.

📡

Live & Local Channels

Add any live stream URL (HLS, DASH, etc.) or load local XSPF and M3U playlists. Import entire channel lineups from M3U files with EPG channel IDs. Mix live streams with your personal media library.

📢

In-App News Feed

Stay informed with software updates and network announcements via the built-in news modal that checks for new messages on startup.

🔍

Channel Search & Filter

Instantly find any channel with the built-in search box. Type a name or number and the sidebar filters in real time — no more scrolling through a long lineup.

Favorites

Press F to star any channel. Favorites appear highlighted with ★ in the sidebar and channel guide, so your go-to stations are always easy to spot. Filter the list to show only your starred channels.

📋

Per-Channel Schedule Overlay

Press G to pull up a live schedule strip for the current channel — showing now-playing and upcoming programmes for live channels, or now/next track cards with progress bars for local playlists.

📡

Custom EPG Sources

Add your own XMLTV guide data URLs or local .xml files via the built-in EPG Sources Editor. Your custom sources are merged with the default guide on every refresh.

Built-in Channel Editor

Add, remove, reorder, and duplicate channels directly in the app. Import M3U playlists with one click. Configure names, URLs, playlists, watermarks, EPG IDs, and shuffle settings — no manual JSON editing required.

🏷️

Network Bugs & Watermarks

Assign transparent PNG watermarks to your channels. Display a logo in the corner of the video for that authentic network broadcast look.

📺

Retro CRT Experience

Phosphor-amber UI, scanline overlays, channel static transitions, a resizable sidebar, and a rotary knob dial for an authentic vintage television feel.

🛡️

Auto-Retry & Stream Recovery

Local files automatically retry on error with exponential backoff. Live streams detect freezes (8-second watchdog) and reconnect automatically with deadline-based safeguards — so you spend less time staring at static.

💾

Smart Resume

Automatically remembers where you left off for local files. Close the app, come back tomorrow, and continue exactly where you stopped.

🔄

Auto-Updated Lineup

Channel lists sync automatically in the background. Hit the ↺ LINEUP button to manually check for updates, or let it happen on its own. Software update notifications keep you on the latest version.

💬

Subtitle Toggle

Turn closed captions on or off with the CC button. Subtitle state persists across channel changes so you don't have to re-enable it every time.

⌨️

Media Key Support

Works seamlessly with keyboard media keys and remotes. Change channels, control volume, play and pause without touching the mouse.

🖥️

True Fullscreen

Multi-monitor aware fullscreen mode with display sleep suppression and double-click to toggle. Mouse-triggered overlay gives you full control without leaving fullscreen — perfect for a dedicated living room setup.

📄

Rotating Log File

Detailed diagnostics are captured in a 5×1 MB rotating log. Press Ctrl+L at any time to open the log file for troubleshooting — invaluable for diagnosing stream issues or reporting bugs.

🆓

Completely Free

No subscription fees, no account creation, no hidden charges, no tracking. RetroTV is free and open-source software, plain and simple.

Your Channels
$0
Cost to Use
3
Platforms
v2.0
Current Version
Local Files
Getting Started

Up & Running In Minutes

01
📥

Install

Download RetroTV — the Windows installer includes ffmpeg for DVR recording. Just make sure VLC Media Player is also installed. The setup wizard will guide you on first launch.

02
📡

Add Streams

Use the setup wizard to choose curated channels or import an M3U playlist. Or open the Channel Editor anytime to paste URLs, build channels from video files, or import M3U/M3U8 playlists.

03
📺

Watch

Flip channels with arrow keys, surf with 🎲, check the EPG guide on CH 00, record with ● REC, set a sleep timer, and enjoy the retro TV experience.

App Preview

See It In Action

● REC 00:12:34
03 LIVE STREAM
LIVE BROADCAST · STREAMING NOW · RETROTV PLAYER ·
CH 03 · LIVE STREAM · LIVE
LIVE STREAM + DVR — PRESS R TO RECORD
07 MOVIES
🎬
📺 CH 07 — MOVIES — SCHEDULE
▶ NOW PLAYING
Classic Feature Film
████████░░░░░
NEXT ▶
Late Night Cinema
CH 07 · MOVIES · LIVE
EPG SCHEDULE OVERLAY — PRESS G TO TOGGLE
📺 RETRO TV SIMULATOR v2.0
◉ LIVE STREAMS
◉ CHANNEL BUILDER
◉ DVR RECORDING
◉ FAVORITES ★
◉ SLEEP TIMER ⏾
00
GUIDE
01
★ NEWS
LIVE BROADCAST
02
MOVIES
▶ Classic Film (EPG)
03
SPORTS
LIVE BROADCAST
04
MUSIC
LIVE BROADCAST
05
VHS MIX
▶ Track 3 of 24
CH 00 · CABLE GUIDE · INFO
BUILT-IN GUIDE — EPG SCHEDULES, ICONS, DVR & LIVE PREVIEW

Get RetroTV

Download the installer for your platform, add your streams, and you're watching in under a minute. The setup wizard walks you through everything on first launch. No account. No credit card. No catch.

🪟
Windows
Windows 10 / 11 · 64-bit · Includes ffmpeg
▶ Download .exe

* Requires VLC Media Player installed on your system. ffmpeg for DVR recording is included in the Windows installer.

Python 3.8+ (source)
VLC Media Player
ffmpeg included in installer
Pillow (optional)