Kepuli-TV

The README of the Kepuli-TV browser extension, version 1.6.3. Source on GitHub

Your own IPTV subscription, played in a browser tab: live TV with a programme guide, films and series, recording, in thirty languages. Free and open source.

Add to Chrome Add to Firefox

Kepuli-TV playing a live channel beside the channel list

▶ Watch the four-minute tour

Opens on YouTube. Everything shown is fictional demo content.

Browse channels by country and topic while watching live TV.

Explore the programme guide while playback continues in the mini-player.

Browse series details, seasons and episodes.

Play an MKV episode with text subtitles and choose their language and size.

Watch a movie with its description and details beside your catalogue, shown as covers.

A free, open-source IPTV player for Chrome and Firefox. Bring your own Xtream Codes account, M3U playlist or Stalker portal, and watch live TV, films and series in a browser tab. There is no app to install and no account with us, and your details stay in your browser.

Browser	Install
Google Chrome 116 or newer	Chrome Web Store
Mozilla Firefox 140 or newer	Firefox Add-ons

Watch the four-minute tour on YouTube

Key features

Live TV by country and topic, with what is on now, an interactive programme guide, catch-up and programme search
Films and series as covers, with the plot, rating, director, cast and the file's format; playback resumes where you stopped, and the next episode follows
A start page with what you left halfway, what is on your channels now and soon, and the channels you watched lately
MKV in the browser, seeking included, with subtitles in the size and style you choose and every audio track, AC-3, E-AC-3 and DTS too
Recording of the channel you watch, or a programme planned from the guide, kept in the browser and saved as a file when you like
Favourites everywhere, personal channel lists, and only the countries and categories you choose
Several accounts side by side, and sync between computers through the browser's own sync, off until you turn it on
Chromecast, picture-in-picture, and a hand-off to VLC or another player
Made for the keyboard, in thirty languages, dark or light

Getting started

Install Kepuli-TV from your browser's store and click its toolbar icon.
Paste your provider's M3U address, or enter the Xtream Codes server, user name and password, or a Stalker portal with the MAC address registered to your subscription.
Pick a country and a channel. Press ? for the keyboard shortcuts.

Kepuli-TV contains no channels or content: you need your own subscription.

User guide

The user guide covers everything in detail: accounts, Stalker portals, recording, sync, the programme guide, the keys, the settings and what to do when something goes wrong.

Found a bug? Open a GitHub issue with your browser and the steps that lead to it. Leave out your credentials and any stream address that contains them.

Intended use

Kepuli-TV is a player. It contains, hosts and indexes no media, channels, playlists or providers, and does nothing without credentials the user brings. Use it only for content you have the right to watch, such as your own subscription, and record only for your own use. The author does not provide, sell or advise on IPTV subscriptions, and such issues are closed.

Your credentials are kept in the browser's own storage on your computer, and reach other computers only if you turn on sync and include passwords. See the privacy policy and the terms of use.

Development

There is no build step: the files are what the browser runs. To try a change:

Chrome: chrome://extensions → Developer mode → Load unpacked → this folder, or node dev/dev.mjs for a profile of its own that reloads on every change
Firefox: node firefox/build.mjs, then about:debugging → This Firefox → Load Temporary Add-on → firefox/dist/manifest.json
Tests: node dev/unitcheck.mjs, and node dev/playcheck.mjs against the mock server in dev/mock/ (run sh dev/mock/media.sh once first)

More in Developing Kepuli-TV (structure, languages, screenshots, publishing) and How Kepuli-TV works (data, categories, playback routes, connection modes), with FIREFOX.md and CHROMECAST.md beside them. Coding agents start from AGENTS.md, and each directory has its own.

Licence

The project's own code is MIT licensed, see LICENSE. The vendor/ directory holds third-party code on its own terms: hls.js and mpegts.js under Apache-2.0, and vendor/ffaudio/ built from FFmpeg under LGPL-2.1+. The build commands are in dev/wasm/build.sh, so that the relinking required by LGPL 2.1 §6 is possible.