suxuang/myIPTV: A Hand-Maintained M3U Playlist for Chinese Satellite and Cable Channels

What suxuang/myIPTV Actually Is

The repository is a distribution point for playlist files, not a program. The top level contains ipv4.m3u, ipv6.m3u, 移动IPTV.m3u, APTV手机专享.m3u, 榴芒电视.txt and 移动IPV6.txt, plus directories named back, img, player and tvlog. Each file is a list of channel entries that an IPTV client reads. The README describes the work as 纯手工不定期更新维护, hand-maintained and updated on no fixed schedule, and the update log runs from 2024/04/30 to 2026/08/18, which shows the shape of the maintenance: many small entries, each one repairing or adding a handful of channels.

The audience is narrow and specific. You need a player that accepts an M3U subscription URL, and you need to be comfortable with the fact that the channel list changes without notice. The README recommends PotPlayer on desktop, DIYP影音, TiviMate and Televizo on Android and Android TV, and zFuse and APTV on iOS. It singles out TiviMate for Android TV because it reloads automatically on a stream drop or network stall, and APTV on iOS because the free tier covers one configuration. That recommendation is the clearest statement of who this is for: people who already own one of those players.

How the M3U Subscription Flow Works

There is no server component in this project. The mechanism is a raw file served by GitHub, wrapped in a proxy address that the README calls a 加速代理, an acceleration proxy. The recommended IPv4 link is https://gh-proxy.org/raw.githubusercontent.com/suxuang/myIPTV/main/ipv4.m3u. Your player fetches that URL on a timer, parses the M3U entries, and renders the channel list. When the author edits ipv4.m3u and pushes, the next refresh picks up the change. Nothing else is involved: no API, no database, no EPG service that the repository hosts.

The README does mention 节目预告, programme guide data, and the update log records fixes to it, but the repository layout shows no XMLTV file at the top level, so the guide data is not something you can inspect here. Treat the EPG claims as player-side. The same applies to the 台标, the channel logos: the img directory exists, but the README does not document how a logo is mapped to a channel entry. If a logo is wrong in your player, you are looking at a problem the repository does not explain how to fix.

The practical consequence is that your experience depends almost entirely on the player. A player that caches aggressively will show you a stale list for hours after a push. A player that refreshes on every launch will show you the newest list but will also surface every broken entry the moment it appears.

Subscribing in PotPlayer or TiviMate

The README gives no installation steps because there is nothing to install. You add the subscription URL to a player you already have. The recommended IPv4 link is the one to start with; the README says the IPv6 sources are no longer updated and tells readers to switch addresses, so ipv6.m3u is a dead end for new setups.

In a player that accepts a plain URL, the subscription is a single string:

https://gh-proxy.org/raw.githubusercontent.com/suxuang/myIPTV/main/ipv4.m3u

Paste that into the playlist or subscription field and let the player load it. You should see a channel list grouped by category, with CCTV and satellite channels near the top. The README offers a second, shorter list for mobile users, 移动专享, at https://gh-proxy.org/raw.githubusercontent.com/suxuang/myIPTV/main/移动专享.txt. That file is a TXT list rather than an M3U, so check that your player accepts the format before switching to it.

The one setting the README asks you to change is automatic refresh. It states that because there are many sources, some may fail to play, and it asks readers to enable the player's auto-refresh so the newest list arrives without manual work. In TiviMate this is the reload behaviour the README credits with keeping playback stable. If your player has no such option, you will be re-adding the URL by hand after every broken channel.

The Failure Mode Is Built Into the Design

The README is unusually direct about this: 部分直播源可能无法正常播放, some sources may not play correctly. The update log confirms the pattern rather than contradicting it. Entries like 2025/08/07 直播源挂码了, the sources went down, and 2025/09/18 如果看不了就换个组, if you cannot watch it, switch to another group, describe a repository whose job is chasing streams that move. The author also added backup channels for CCTV and satellite stations in 2025/01/21 after readers reported they would not play, which means the primary entries had already failed.

This is the wrong tool if you need one specific channel to work at one specific time. A playlist that is repaired by hand every few weeks cannot promise that. It is also the wrong tool if you want a service with a contact channel: the README offers an email address for communication, and that is the extent of the support model. There is no issue tracker workflow described, no status page, and no versioned release you can pin to. Every fetch gives you whatever is on main at that moment.

How It Differs From an IPTV Player App

Search traffic around this name mixes two different things. MyIPTV Player is an application, with its own login, activation and playlist upload screens. suxuang/myIPTV is a playlist. The difference in approach matters when you are choosing: an app gives you a client, an interface and a support surface, and asks you to supply a source. This repository gives you a source, and asks you to supply the client. The README names the clients it expects you to bring, which is the opposite of how a player app positions itself.

If you want the app model, install one of the players the README lists and point it at this subscription. If you want a source model with more control, the alternative is to maintain your own M3U file: copy the entries you actually watch out of ipv4.m3u into a local file, and update that file yourself. That is more work and it puts the stream-chasing on you, but it removes the dependency on a third-party proxy address and on someone else's refresh schedule. The repository's own structure supports this reading, since the files are plain text and can be copied without any tooling.

Maintenance, Licence and the Cost of Following Along

The last push to the repository was on 2026-09-13, which is recent, and the repository is not archived. The README describes the update cadence as irregular by design, 不定期更新维护, so a quiet week is normal and not a signal that the project stopped. The update log shows the author responding to breakage rather than following a release plan, with gaps of weeks between entries and bursts of activity when several sources fail at once.

The repository lists no licence, and the README does not add one. What it does say is that all sources are collected from the internet, are for study and research only, that commercial use is prohibited, and that the project stores no streaming content, with responsibility for use falling on the user. That is the author's stated position, not a legal analysis, and it does not resolve the licensing status of the streams themselves. If you plan to use this in any setting beyond personal viewing, the absence of a licence and the README's own restriction are the first things to bring to whoever handles that question for you.

The upgrade cost is not a version bump. It is the ongoing cost of a subscription URL that changes contents without a changelog you can diff, plus the proxy dependency. If gh-proxy.org becomes unavailable, the recommended link stops resolving, and the README's fallback is the raw GitHub address, which in some networks is the reason the proxy was recommended in the first place.

Editorial conclusion

Adopt suxuang/myIPTV if you already run an IPTV player that accepts an M3U URL and you want Chinese satellite and cable channels without building a playlist yourself. Do not adopt it if you need a stable, guaranteed stream for a specific channel, or if you expect an official app with a login and a support channel: there is no app, no account and no SLA here. Before subscribing, open one of the raw .m3u files in a text editor and confirm that the channel names and stream URLs match what you need, because the README itself says part of the sources may fail to play and recommends turning on your player's automatic refresh.

Frequently asked questions

Official sources

1. Issues
2. README
3. suxuang/myIPTV on GitHub