chuiziyao/wushuang-iptv
Media & DesignCapture, verify and export your own subscribed IPTV multicast streams as M3U playlists for home TVs, phones and tablets.
What it does
无双IPTV is a Windows-first desktop tool for people who already pay for a home IPTV subscription and want to watch it on more devices. It captures multicast stream addresses from a set-top box, verifies that each channel actually plays, and exports the result as an M3U playlist.
The workflow has four stages: a wiring wizard that produces cabling steps and a topology diagram for your setup, packet capture via Windows' built-in pktmon (no Wireshark or Npcap needed), channel verification that parses MPEG-TS tables and reports codec, resolution and availability without ffmpeg, and M3U generation in both udp:// multicast and http:// udpxy forms. A national reference library covering 31 provinces and four carriers can be loaded by province and carrier, updated online or imported offline, but the project treats it only as candidate addresses and recommends verifying on your own line.
A built-in udpxy-equivalent service converts multicast to HTTP unicast for Wi-Fi playback, and playlists can be pushed to an SMB or WebDAV NAS share for always-on forwarding with Tvheadend or udpxy. Version 2.1 adds a WushuangIPTV-CLI.exe console mode with JSON output and exit codes, intended as an AI-tool entry point.
Getting started
On Windows 10 1809 or later, download WushuangIPTV.exe from Releases and double-click it. The graphical version requests administrator rights on launch, which the capture step needs.
- Wiring wizard (①): choose your scenario — dumb switch, router IPTV port/VLAN binding, or an already-bridged network — and follow the cabling steps.
- Capture (②): start capture, change channels one by one on the set-top box, stopping 3–5 seconds on each, then stop and analyze. Add the discovered channels to the list. Bridged or switch-free setups can skip this and load the reference library instead.
- Verify (③): select the multicast NIC and verify all channels.
- Export (④): choose an output directory and save the M3U, optionally pushing it to a NAS.
- Open the playlist in VLC, Kodi, DIYP, or the project's companion TV APK.
For command-line use, run the CLI binary from Releases:
WushuangIPTV-CLI.exe info
WushuangIPTV-CLI.exe verify --province 浙江 --carrier 电信 --out verified.json
WushuangIPTV-CLI.exe m3u --channels verified.json --outdir D:\iptv
Results go to stdout as a single JSON object, progress to stderr as JSONL, and exit codes signal success, failure, bad arguments or missing admin rights. Only capture needs administrator privileges. On first run, allow the Windows firewall prompt if it appears. Full command reference and the AI-tool entry point are in the project docs.
Platform support
Windows is the only production platform at v2.1.0. Linux x64, macOS Intel/Apple Silicon and HarmonyOS NEXT PC are v2.1.0-beta builds that have not been tested on real IPTV hardware and should not be used for production before verification on your own environment. Linux is reported as functionally validated under WSL Ubuntu 22.04, macOS shares the POSIX code path and is covered by CI, and the HarmonyOS HAP is built but unsigned and unverified on a device.
On Linux/macOS, source runs need Python 3.10+ and tkinter, and capture needs tcpdump with sudo. WSL2's default NAT mode cannot receive physical LAN multicast, so it needs mirrored networking or a real machine. macOS unsigned builds require right-click → Open. The HarmonyOS version has no capture at all because third-party apps lack raw capture permission, and verifying real streams requires a HarmonyOS PC with wired access to the IPTV network.
Constraints and legal notes
The tool is intended for personal study and home-LAN use with IPTV content you already subscribe to. The project asks users not to share or sell captured sources, run public-facing services, clone set-top box accounts for unpaid services, or map the forwarding service to the public internet. The reference library is downloaded on demand from the community repository xisohi/CHINA-IPTV rather than bundled, and candidate addresses need local verification because carriers change them. The forwarded UDP-to-HTTP service is LAN-only. The code is MIT-licensed.
HotRepo's take
This is a narrowly scoped utility with unusually detailed operational documentation for a small project: screenshots of each step, a dedicated page for the Shandong Mobile blind-port case, cross-platform caveats and a CLI protocol. HotRepo first recorded it on the Python new-project list on 2026-11-19 with 104 stars and a net gain of 3 stars in a one-hour window; that is a single short observation, not a trend. The main caveat for prospective users is the delivery model: the recommended path is running prebuilt Windows executables and bundled APK files, so the source-to-binary correspondence is worth checking yourself before running them.
Companion APKs
The repository ships two Android files: a TV version (about 1.6 MB, Android 4.0+, remote-control and number-key navigation, favorites) and a phone version with touch and landscape fullscreen. Both play the playlist once you enter its address.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- iptv-org/iptvReady-made M3U playlists of publicly available live TV streams from around the world for anyone who wants free channels in their own player.
- anITer/utvAn Android TV IPTV player tuned for Beijing Unicom multicast streams, handling udpxy fallback, MP2 and Dolby audio, and channel scanning.
- fmhyplay/androidAndroid TV-first browser and player that turns user-added streaming sites and IPTV playlists into a native playback experience.
- AndreyPavlenko/FermataA folder-based Android audio, video and IPTV player for people who organize media in directory trees rather than libraries.
- LibreSpark/LibreTVSelf-hosted search-and-play frontend that aggregates third-party video sources and IPTV playlists into one private streaming site.