The open-source IPTV player for Linux — live TV, EPG, timeshift and recordings.
A fast, modern IPTV player for Xtream Codes & M3U — with a full EPG guide, live timeshift and catch-up, one-click recording, and multiview for up to nine channels at once. Built on mpv, made for Linux — and runs on macOS & Windows too.
Linux · macOS · Windows — free & open source
Built for how people actually watch TV.
Not a repurposed media library — a TV client, with the timeline, the guide and the recorder where you expect them.
Timeshift & catch-up
Scrub back into a channel's archive on a live timeline, or jump straight to a past programme from the guide.
Multiview
Watch up to nine live channels at once in a grid — mix different playlists, click any one for audio, with per-window timeshift and subtitles.
Pause live TV
DVR-style pause and resume behind live — the player shows exactly how far behind you are.
Full EPG guide
A real programme grid with search, reminders and a configurable list of what's coming up next.
One-click recording
Record the stream you're watching over a single connection, with timers, size caps and a Recordings library.
Multi-provider
Several Xtream or M3U playlists side by side, each with its own EPG, auto-refresh and custom guide URL.
Smooth playback
A built-in mpv engine, with Chromecast, Trakt sync, themes and full keyboard control.
Your own files too
Point it at a folder or a mounted share and your videos sit beside the provider's — with posters, resume, series built from the file names, and a play queue for music.
Clean, dark, and out of your way.
Download the latest release.
Linux
Not sure? Get the AppImage — it runs on any distribution with no install. Choose .deb on Debian/Ubuntu. Pick Intel / AMD unless you're on an ARM machine (Raspberry Pi, ARM server).
🐧 AppImage: make it executable and run it — nothing to install: chmod +x dopeIPTV-*.AppImage && ./dopeIPTV-*.AppImage. .deb (Debian/Ubuntu): sudo apt install ./dopeIPTV-*.deb. .rpm (Fedora/RHEL): sudo dnf install ./dopeIPTV-*.rpm.
macOS
Apple Silicon (M-series), macOS 15 or later. Not sure which Mac you have? Apple menu → About This Mac. Intel Macs are no longer supported — the last Intel build is on the GitHub releases page.
🍎 Open the .dmg and drag dopeIPTV to Applications. Because the app isn't notarized by Apple yet, the first launch may be blocked — right-click the app → Open, then Open in the dialog (or allow it under System Settings → Privacy & Security → Open Anyway). If macOS instead says the app is “damaged”, clear the download flag in Terminal: xattr -dr com.apple.quarantine /Applications/dopeIPTV.app. It's safe — the warning only means the build isn't code-signed.
Windows
Portable build — unzip and run, nothing to install. Newest platform, still being polished.
🪟 Unzip the folder and run dopeiptv.exe. Because the app isn't code-signed yet, SmartScreen may show “Windows protected your PC” — click More info → Run anyway. It's only a warning, nothing is blocked or removed.
↻ Generated on the server from the slimture/dopeIPTV GitHub releases — new builds appear automatically.
🔒 Verify your download — SHA-256 checksums · sha256sum -c SHA256SUMS
What's new
Written for people who use the app, not for people who read diffs.
Read the release notes
Mostly Linux this time: the desktop icon, the links in the About window, and a handful of things that went wrong when a list and the player disagreed about what you had selected.
Linux desktop
- The app appears in your menu, with its icon. On Wayland GNOME and KDE take a window's icon and name from the .desktop entry matching it and ignore what the app itself sets — so run from an AppImage, where nothing has ever installed one, the taskbar showed a blank placeholder however good the icon inside the download was. The app now offers, once, to add an entry; say no and nothing is written, and the same switch lives under Settings > Playback. Installed from the
.deb, the entry is already there and nothing is asked. - The icon is the same size as everyone else's. It was drawn edge to edge while every icon beside it carries a margin — GNOME asks for about 80% of the canvas, which is the same thing Apple asks for and the same fix the macOS Dock icon got in 1.2.10.
- An icon that will not appear at all now has a cause you can read. Where a stale
icon-theme.cacheexists, GTK reads that instead of the directory and an icon added since is invisible — the app drops one older than its own icons, and writes a line to the log saying what it found. - Links in the About window work. Website, download, the Trakt pages: all of them did nothing from a packaged build. Opening a link starts a browser as a child of this process, and it was inheriting the bundle's library paths and falling over before it drew anything — exactly the fault external mpv had, and the same cure.
Watching a series
- Turning grid view on and off inside a series keeps the episodes. It dropped back to the series list instead, and double-clicking there then tried to play the series itself: an error, and whatever was playing stopped. Three related faults behind it, all the same shape — a list row and the player disagreeing about what had been selected — and Favorites, Watchlist and Watched had their own versions of it.
- A hidden channel no longer hides a film. Provider ids are only unique within a type, so hiding live channel 123 could hide movie 123 as well.
Elsewhere
- The right-hand panel has one scrollbar, not two. The info box was its own scroll area inside the panel's, and the wheel — a trackpad especially — went to whichever of them the pointer happened to be over.
- The "Next episode" card sits where the picture ends, rather than a control bar's height above it when there is no control bar there.
- Your account stays out of the log. An Xtream stream URL carries the whole account in it, and these logs are meant to be shared in bug reports. Credentials are now masked wherever they appear — the URL shapes we know, and the account's own values everywhere else.
- The Chromecast bridge only answers for its own files. It listens on the LAN so the television can reach it, so everything else on the network can ask it too; it now names what it will serve instead of guessing at what to refuse.
- macOS can try the other fullscreen path. Start with
DOPEIPTV_MAC_RASTER=1to use the presentation path that cured this on Linux and Windows. Opt-in, so both can be compared from one build.
macOS: Apple Silicon only
1.2.10 was the last release with an Intel .dmg. Homebrew moved macOS x86_64 to Tier 3 in September 2026 and stopped building the packages the Intel build was assembled from; Apple has said macOS Tahoe 26 is the last macOS for Intel. Apple Silicon is unaffected.
Full details in the changelog.
Linux is and remains the primary target - Windows and macOS are a bonus.
Frequently asked questions
What is dopeIPTV?
dopeIPTV is a free, open-source desktop IPTV player for Xtream Codes and M3U playlists. It gives you a full EPG guide, live timeshift and catch-up TV, one-click recording, and multiview for up to nine channels at once — all in one native app built on the mpv engine.
Is dopeIPTV free?
Yes. dopeIPTV is completely free and open source under the GPL-3.0 licence, with no ads, no tracking and no account required.
Which operating systems does dopeIPTV support?
dopeIPTV is built for Linux and also runs on macOS and Windows. Linux ships as an AppImage, .deb and .rpm; macOS as a .dmg; and Windows as a portable build.
Does dopeIPTV work with Xtream Codes and M3U?
Yes. You can add Xtream Codes logins (server, username and password) and M3U/M3U8 playlist URLs. Several providers can run side by side, each with its own EPG and auto-refresh.
Does dopeIPTV have an EPG, timeshift and catch-up?
Yes. dopeIPTV shows a full XMLTV programme guide with now/next, and supports live timeshift and catch-up, so you can pause live TV or scrub back into a channel's archive.
Can dopeIPTV record live TV?
Yes. You can record the stream you're watching over a single connection, with timers, size limits and a Recordings library.
What is multiview?
Multiview lets you watch up to nine live channels at once in a grid, mixing different playlists, each with per-window timeshift and subtitles.
Does dopeIPTV show ads or track me?
No. dopeIPTV has no ads, no tracking and no accounts. Metadata and artwork come from TMDB and optional watched-history sync uses Trakt — both only if you choose to use them.
Does dopeIPTV provide IPTV channels or a subscription?
No. dopeIPTV is only a player — it does not provide, sell or host any channels or content. You connect your own Xtream Codes or M3U provider.
What languages is dopeIPTV available in?
dopeIPTV is available in 26 languages besides English — including Spanish, German, French, Arabic, Hindi, Chinese, Japanese and more — with right-to-left support for Arabic, Hebrew, Persian and Urdu.
Free software, standing on giants.
dopeIPTV is free and open source under the GPL-3.0 licence — no ads, no tracking, no accounts. It's built with, and grateful to, these projects and services:
This product uses the TMDB API but is not endorsed or certified by TMDB. This product uses the Trakt API but is not endorsed or certified by Trakt. All trademarks are the property of their respective owners.