Yuki-iptv – An IPTV player with EPG support (Ubuntu PPA)

Last updated: May 5, 2024 — 1 Comment

Linux is getting more IPTV player applications in recent years. Here I’m going to introduce yuki-iptv, a new one with EPG support.

Personally, I prefer hypnotix which is developed by Linux Mint team, since it has a large list of built-in TV channels. But if you want more features, then yuki-iptv is a good choice to try out.

The IPTV player does NOT provide any content or TV channels. User has to manually add M3u / M3u8 / XSPF playlists (see github.com/iptv-org/iptv) and/or TV guide address via config dialog.

Yuki-iptv add playlist

Besides basic M3u / M3u8 / XSPF playlists support, the app also support viewing unencrypted streams UDP (multicast), HTTP, HLS (M3u8), XTream API, as well as TV program (EPG) support in XMLTV and JTV formats.

It uses mpv for video playback, and provides record button, to either record current playback, or record certain channels in user given time period. So you won’t miss your favorite TV shows, since they are saved as local videos in your system.

By default, it saves recordings to /home/USER/.config/yuki-iptv/saves, which is a hidden folder (press Ctrl+H to view), though you can change it to other location in settings page.

Other useful features of yuki-iptv include:

  • Display technical info (e.g., video/audio codec, bit-rate, resolution) in player window.
  • Set video contrast, brightness, hue, saturation, gamma for each channel.
  • Change user agent / HTTP Referer for each channel
  • M3u playlist editor
  • TV archive / catchup
  • MPRIS support

How to Install yuki-iptv in Ubuntu & other Linux

Option 1: .deb package

The app provides .deb package for Debian and Ubuntu, available to download at Github releases page:

After downloading the .deb package, either double-click open with “Software Install” then install it. Or press Ctrl+Alt+T on keyboard to open terminal, and run command to install it:

sudo apt install ~/Downloads/yuki-iptv*.deb

The command will install the package if you saved it to user Downloads folder.

Option 2: Ubuntu PPA

For choice, you may use Ubuntu PPA instead to install it in Ubuntu 20.04, Ubuntu 22.04, Ubuntu 24.04 and Ubuntu 23.10.

NOTE: This is a daily build PPA that contains the most recent development build, which will more likely run into issues.

  • First, press Ctrl+Alt+T on keyboard to open terminal. Then run command to add the PPA:
    sudo add-apt-repository ppa:yuki-iptv/yuki-iptv-stable

  • After adding PPA, run command to install the iptv player:
    sudo apt install yuki-iptv

    Run sudo apt update to update package cache if unable to locate ‘yuki-iptv’

For Fedora, openSUSE, it provides the packages through the OBS build service.

Uninstall yuki-iptv

To remove the TV viewer, simply open terminal and run command:

sudo apt remove --autoremove yuki-iptv

And, remove the PPA (if added) by running command:

sudo add-apt-repository --remove ppa:yuki-iptv/yuki-iptv-develop


I'm a freelance blogger who started using Ubuntu in 2007 and wishes to share my experiences and some useful tips with Ubuntu beginners and lovers. Please comment to let me know if the tutorial is outdated! And, notify me if you find any typo/grammar/language mistakes. English is not my native language. Contact me via [email protected] Buy me a coffee: https://ko-fi.com/ubuntuhandbook1

One response to Yuki-iptv – An IPTV player with EPG support (Ubuntu PPA)

  1. Hi.
    Thanks for Your job. Nice and clear as professionalist.
    I’m new user of LInux – currently Mint 21.3 Cinnamon.
    I’m using Yuki a few weeks, and I like it.
    I had some issues two days ago and I needed clear all config files and install new version of Yuki follow instruction from Your site. But ! New version NOT incude icon (and access) to catch-up.
    Do You know why?
    With Regards – Zibi.

Leave a Reply

Text formatting is available via select HTML.

<a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>