ustvgo-iptv 0.1.4

USTVGO Free IPTV

USTVGO-IPTV is an app that allows you to watch free IPTV.

It extracts stream URLs from ustvgo.tv website, generates master playlist with available TV channels for IPTV players and proxies the traffic between your IPTV players and streaming backends.

✨ Features

• 🔑 Auto auth-key rotation

  As server proxies the traffic it can detect if your auth key is expired and refresh it on the fly.

• 📺 Available TV Guide

  TV Guide repo generates EPG XML for upcoming programs for all the channels twice an hour.

• Two iconsets for IPTV players with light and dark backgrounds

  There are 2 channel iconsets adapted for apps with light and dark UI themes.

• 🗔 Cross-platform GUI

  GUI is available for Windows, Linux and MacOS for people who're not that much into CLI.

🚀 Installation

• CLI

  pip install ustvgo-iptv
  

• GUI

  You can download GUI app from Releases for your OS.

⚙️ Usage

• Basic usage

  To generate master playlist, you could simple run app without any arguments.

  ustvgo-iptv
  

  

• Iconset

  By default channel icons are adapted for dark backgrounds, in case your IPTV player have light UI theme you can switch iconset to appropriate with following option --icons-for-light-bg

  ustvgo-iptv --icons-for-light-bg
  

• Access logs

  To enable access logs for tracking requests activity use option --access-logs

  ustvgo-iptv --access-logs
  

• Server port

  By default the port is 6363. You can change it with option --port

  ustvgo-iptv --port 1234
  

• Parallel requests

  When server starts it initiate collecting stream URLs for master playlist using 10 parallel requests. You can specify number of parallel requests with option --parallel

  ustvgo-iptv --parallel 12
  

• GUI

  

  With GUI you can set most of the popular options: port, icons scheme, access logs. If you wanna set other options, you can set them with config file on following path:

  • Linux: ~/.config/ustvgo-iptv/settings.cfg
  • Mac: ~/Library/Application Support/ustvgo-iptv/settings.cfg
  • Windows: C:\Users\%USERPROFILE%\AppData\Local\ustvgo-iptv\settings.cfg

🔗 URLs

To play and enjoy your free IPTV you need 2 URLs:

1. Your generated master playlist: 🔗 http://127.0.0.1:6363/ustvgo.m3u8
2. TV Guide (content updates twice an hour):
   • 🔗 XML EPG for IPTV players with light UI theme
   • 🔗 XML EPG for IPTV players with dark UI theme

▶️ Players

Here is a list of popular IPTV players.

USTVGO's channels have EIA-608 embedded subtitles. In case if you're not a native speaker and use TV, Cartoons, Movies and Shows to learn English and Spanish languages I would recommend you following free open-source cross-platform IPTV players that can handle EIA-608 subtitles:

• VLC

  This old beast could play any subtitles. Unfortunately it doesn't support TV Guide.

  • Play

    vlc http://127.0.0.1:6363/ustvgo.m3u8
    

• MPV

  Fast and extensible player. It supports subtitles, but not that good as VLC, sometimes you could encounter troubles playing roll-up subtitles. Unfortunately it doesn't suppport TV Guide.

  • Play

    mpv http://127.0.0.1:6363/ustvgo.m3u8
    

• Jellyfin Media Player

  

  Comfortable, handy, extensible with smooth UI player. Supports TV Guide, has mpv as a backend.

  Supports subtitles, but there is no option to enable them via user interface. If you want to enable IPTV subtitles you have to use following "Mute" hack.

  • Enable IPTV subtitles

    I found a quick hack to force play embedded IPTV subtitles, all you need is to create one file:

    Linux: ~/.local/share/jellyfinmediaplayer/scripts/subtitles.lua

    Linux(Flatpak): ~/.var/app/com.github.iwalton3.jellyfin-media-player/data/jellyfinmediaplayer/scripts/subtitles.lua

    MacOS: ~/Library/Application Support/Jellyfin Media Player/scripts/subtitles.lua

    Windows: %LOCALAPPDATA%\JellyfinMediaPlayer\scripts\subtitles.lua

    And paste following text in there:

    -- File: subtitles.lua
    function on_mute_change(name, value)
        if value then
            local subs_id = mp.get_property("sid")
            if subs_id == "1" then
                mp.osd_message("Subtitles off")
                mp.set_property("sid", "0")
            else
                mp.osd_message("Subtitles on")
                mp.set_property("sid", "1")
            end
        end
    end
    
    mp.observe_property("mute", "bool", on_mute_change)
    

    After that every time you mute a video (🅼 key pressed), you toggle subtitles on/off as a side effect.

  • Play

    1) Settings -> Dashboard -> Live TV -> Tuner Devices -> Add -> M3U Tuner -> URL -> http://127.0.0.1:6363/ustvgo.m3u8
    2) Settings -> Dashboard -> Live TV -> TV Guide Data Providers -> Add -> XMLTV -> URL -> https://raw.githubusercontent.com/interlark/ustvgo-tvguide/master/ustvgo.for-dark-bg.xml
    3) Settings -> Dashboard -> Scheduled Tasks -> Live TV -> Refresh Guide -> Task Triggers -> "Every 30 minutes"
    

  • Note

    Some versions does not support compressed (*.xml.gz) TV Guides.
    

• IPTVnator

  

  Player built with Electron so you can run it even in browser, has light and dark themes.

  Support subtitles and TV Guide.

  • Play

    1) Add via URL -> http://127.0.0.1:6363/ustvgo.m3u8
    2) Settings -> EPG Url -> https://raw.githubusercontent.com/interlark/ustvgo-tvguide/master/ustvgo.for-light-bg.xml.gz
    

👍 Support

• ustvgo.tv is wonderful project which can offer you a free IPTV, please support these guys buying VPN with their referral link. With VPN you can watch even more of their channels, like extra 25 or so.

• Also I would highly appreciate your support on this project ⠀