Package: ustvgo-iptv
USTVGO-IPTVis an app that allows you to watchfree IPTV.Itextracts stream URLsfromustvgo.tvwebsite,generates master playlistwith available TV channels for IPTV players andproxies the trafficbetween your IPTV players and streaming backends.Note: See also aportof this app for 123TV service✨ Features🔑 Auto auth-key rotationAs server proxies the traffic it can detect if your auth key is expired and refresh it on the fly.📺 AvailableTV GuideTV Guiderepo generates EPG XML for upcoming programs of all the channels twice an hour.Two iconsets for IPTV players with light and dark backgroundsThere are 2 channel iconsets adapted for apps with light and dark UI themes.🗔 Cross-platform GUIGUI is available for Windows, Linux and MacOS for people who are not that much into CLI.🚀 InstallationCLIpipinstallustvgo-iptvGUIYou can download GUI app fromReleasesfor your OS.Dockerdockerrun-d--name=ustvgo-iptv-p6363:6363--restartunless-stoppedghcr.io/interlark/ustvgo-iptv:latestFor dark icons append following argument:--icons-for-light-bg⚙️ Usage - CLIYou can run the app without any arguments.ustvgo-iptvOptional argumentDescription--icons-for-light-bgSwitch to dark iconset for players with light UI.--access-logsEnable access logs for tracking requests activity.--port 6363Server port. By default, the port is6363.--parallel 10Number of parallel parsing requests. Default is10.--use-uncompressed-tvguideBy default, master playlist has a link tocompressedversion of TV Guide:url-tvg="http://127.0.0.1:6363/tvguide.xml.gz"With this argument you can switch it to uncompressed:url-tvg="http://127.0.0.1:6363/tvguide.xml"--password <PASSWORD>Set password prefix for the URL.Could be used to prevent public playlists scraping.Linuxusers can installsystemd servicethat automatically runs ustvgo-iptv on start-ups ⏰.# Install "ustvgo-iptv" servicesudo-Eenv"PATH=$PATH"ustvgo-iptvinstall-service# You can specify any optional arguments you wantsudo-Eenv"PATH=$PATH"ustvgo-iptv--port1234--access-logsinstall-service# Uninstall "ustvgo-iptv" servicesudo-Eenv"PATH=$PATH"ustvgo-iptvuninstall-service⚙️ Usage - GUIIf you don't like command line stuff, you can run GUI app and click "Start", simple as that.GUI usesconfig fileon following path:Linux: ~/.config/ustvgo-iptv/settings.cfgMac: ~/Library/Application Support/ustvgo-iptv/settings.cfgWindows: C:\Users\%USERPROFILE%\AppData\Local\ustvgo-iptv\settings.cfg🔗 URLsTo play and enjoy your free IPTV you need 2 URLs that this app provides:Your generatedmaster playlist: 🔗http://127.0.0.1:6363/ustvgo.m3u8TV Guide(content updates twice an hour): 🔗http://127.0.0.1:6363/tvguide.xml▶️ PlayersHere is alistof popular IPTV players.USTVGO's channels haveEIA-608embedded subtitles. In case if you're not a native speaker and useTV,Cartoons,MoviesandShowsto learn English and Spanish languages I would recommend you following free open-source cross-platform IPTV players that can handle EIA-608 subtitles:VLCThis old beast could playany subtitles. Unfortunately itdoesn't support TV Guide.Playvlchttp://127.0.0.1:6363/ustvgo.m3u8MPVFast and extensible player. Itsupports subtitles, but not that good as VLC, sometimes you could encounter troubles playing roll-up subtitles. Unfortunately itdoesn't suppport TV Guide.Plaympvhttp://127.0.0.1:6363/ustvgo.m3u8Jellyfin Media PlayerComfortable, handy, extensible with smooth UI player.Supports TV Guide, hasmpvas 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 subtitlesI found a quick hack to force play embedded IPTV subtitles, all you need is to create one file:Linux:~/.local/share/jellyfinmediaplayer/scripts/subtitles.luaLinux(Flatpak):~/.var/app/com.github.iwalton3.jellyfin-media-player/data/jellyfinmediaplayer/scripts/subtitles.luaMacOS:~/Library/Application Support/Jellyfin Media Player/scripts/subtitles.luaWindows:%LOCALAPPDATA%\JellyfinMediaPlayer\scripts\subtitles.luaAnd paste following text in there:-- File: subtitles.luafunctionon_mute_change(name,value)ifvaluethenlocalsubs_id=mp.get_property("sid")ifsubs_id=="1"thenmp.osd_message("Subtitles off")mp.set_property("sid","0")elsemp.osd_message("Subtitles on")mp.set_property("sid","1")endendendmp.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.Play1) 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 -> http://127.0.0.1:6363/tvguide.xml
3) Settings -> Dashboard -> Scheduled Tasks -> Live TV -> Refresh Guide -> Task Triggers -> "Every 30 minutes"NoteSome versions does not support compressed (*.xml.gz) TV Guides.IPTVnatorPlayer built withElectronso you can run it even in browser, has light and dark themes.Support subtitles and TV Guide.Play1) Add via URL -> http://127.0.0.1:6363/ustvgo.m3u8
2) Settings -> EPG Url -> http://127.0.0.1:6363/tvguide.xml.gz👍 Supportustvgo.tvis wonderful project which can offer you a free IPTV, please support these guys buying VPN with theirreferral 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 ⠀