# IPTV | Free TV | Knowledge Base | Instagit

M3U Playlist for free TV channels

GitHub Stars: 17.4k

Repository: https://github.com/Free-TV/IPTV

---

## Articles

### [How to Regenerate the Combined IPTV Playlist After Making Changes](/Free-TV/IPTV/regenerate-combined-iptv-playlist)

Quickly regenerate your combined IPTV playlist after editing lists using the simple python3 make_playlist.py command. Keep your playlist current with minimal effort.

- Tags: how-to-guide
- Published: 2026-06-26

### [Free-TV/IPTV Channel Selection Philosophy: How the Project Curates Quality Over Quantity](/Free-TV/IPTV/iptv-channel-selection-philosophy)

Discover the Free-TV/IPTV channel selection philosophy. Learn how we curate HD reliable streams and mainstream content, prioritizing quality over quantity for the best viewing experience.

- Tags: best-practices
- Published: 2026-06-26

### [How to Update Existing Channel Information in the Free-TV IPTV Playlist](/Free-TV/IPTV/update-existing-iptv-channel-info)

Update Free-TV IPTV playlist channel info effortlessly. Edit the Markdown file, modify channel data, and run the script to regenerate playlist.m3u8.

- Tags: how-to-guide
- Published: 2026-06-26

### [How Channel Numbers Are Assigned and Used in the Free‑TV IPTV Playlist](/Free-TV/IPTV/iptv-channel-numbering-assignment)

Discover how channel numbers are assigned and used in IPTV playlists. Learn how the tvg-chno attribute enables numeric display and direct selection in your IPTV client.

- Tags: how-to-guide
- Published: 2026-06-26

### [How to Test IPTV Stream URLs Before Adding Them to the Playlist](/Free-TV/IPTV/test-iptv-stream-urls-before-adding)

Learn how to test IPTV stream URLs effectively before adding them to your playlist. Discover automated validation techniques and essential tools.

- Tags: how-to-guide
- Published: 2026-06-26

### [How to Troubleshoot IPTV Playlist Playback Issues: A Complete Guide to the Free-TV/IPTV Repository](/Free-TV/IPTV/troubleshoot-iptv-playlist-playback)

Troubleshoot IPTV playlist playback issues with the Free-TV/IPTV repository. Learn to diagnose dead URLs, syntax errors, and geo-restrictions by tracing M3U entries to source files.

- Tags: how-to-guide
- Published: 2026-06-26

### [Streaming Protocols Supported by Free-TV/IPTV: HLS, MPEG-DASH, and SMIL Explained](/Free-TV/IPTV/supported-streaming-protocols-iptv)

Explore Free-TV/IPTV streaming protocols: HLS, MPEG-DASH, and SMIL. Learn how our platform delivers content efficiently.

- Tags: deep-dive
- Published: 2026-06-26

### [How to Mark IPTV Channels as HD vs SD Quality in the Free-TV Playlist](/Free-TV/IPTV/mark-iptv-channels-hd-sd-quality)

Learn to mark IPTV channels as HD or SD quality in your Free-TV playlist. Simply append the Ⓢ symbol for SD channels or use HD for high definition. Easy channel organization.

- Tags: how-to-guide
- Published: 2026-06-26

### [How IPTV Channel Logos Are Specified and Hosted in the Free-TV/IPTV Project](/Free-TV/IPTV/iptv-channel-logo-specification-hosting)

Learn how IPTV channel logos are specified and hosted in the Free TV IPTV project. Discover how tvg-logo attributes in M3U8 files link to external HTTPS URLs for lightweight repository management and direct client fetching.

- Tags: how-to-guide
- Published: 2026-06-26

### [How to Organize IPTV Channels by Source Type (ATSC, DVB-S, Pluto) in Free-TV/IPTV](/Free-TV/IPTV/organize-iptv-channels-by-source)

Learn to organize IPTV channels by source type like ATSC, DVB-S, or Pluto within the Free-TV/IPTV repository. Discover how the script generates playlists from categorized lists.

- Tags: how-to-guide
- Published: 2026-06-26

### [How IPTV Stream URLs Are Parsed from Markdown Tables in Free-TV/IPTV](/Free-TV/IPTV/parse-iptv-stream-urls-from-markdown)

Learn how the Free-TV/IPTV repository parses IPTV stream URLs from markdown tables using [>] markers and hyperlink syntax within the fourth column to create M3U8 playlist entries.

- Tags: how-to-guide
- Published: 2026-06-26

### [How to Add YouTube Live Channel Streams to the Free-TV IPTV Playlist](/Free-TV/IPTV/add-youtube-live-streams-iptv)

Easily add YouTube live channels to your Free-TV IPTV playlist. Follow our simple guide to edit country files and regenerate your master playlist for seamless streaming.

- Tags: how-to-guide
- Published: 2026-06-26

### [How to Manage Geoblocked IPTV Channels Across Countries Using Free-TV/IPTV](/Free-TV/IPTV/handle-geoblocked-iptv-channels)

Learn how to manage geoblocked IPTV channels using the Free-TV/IPTV repository. Discover how country codes and flags help bypass restrictions for seamless viewing.

- Tags: how-to-guide
- Published: 2026-06-26

### [How Country Codes Are Mapped to ISO Codes in IPTV Playlists](/Free-TV/IPTV/iptv-country-code-iso-mapping)

Learn how Free-TV/IPTV maps country codes to ISO codes in playlists. Discover the centralized dictionary in make_playlist.py that standardizes tvg-country attributes for M3U generation.

- Tags: how-to-guide
- Published: 2026-06-26

### [How to Integrate EPG (Electronic Program Guide) with IPTV Channels in Free-TV/IPTV](/Free-TV/IPTV/integrate-epg-iptv-channels)

Learn to integrate EPG with IPTV channels using Free-TV/IPTV. Configure global EPG sources and add EPG IDs to your channel entries for a seamless viewing experience.

- Tags: how-to-guide
- Published: 2026-06-26

### [How the make_playlist.py Script Generates M3U8 Files for IPTV](/Free-TV/IPTV/make-playlist-py-script-m3u8-generation)

Learn how make_playlist.py generates M3U8 files for IPTV. This Python script transforms Markdown channel lists into compliant playlists by parsing entries and creating EXTINF metadata.

- Tags: how-to-guide
- Published: 2026-06-26

### [How to Contribute Changes to the Free-TV/IPTV Repository Using Pull Requests](/Free-TV/IPTV/contribute-iptv-repository-pull-requests)

Learn to contribute to the Free-TV/IPTV repository by editing markdown files, validating changes, and submitting pull requests. Enhance your favorite channels today!

- Tags: how-to-guide
- Published: 2026-06-26

### [How to Handle Broken or Invalid Stream URLs in IPTV Playlists: The Free-TV/IPTV Workflow](/Free-TV/IPTV/handle-broken-iptv-stream-urls)

Learn how to handle broken IPTV stream URLs in Free-TV/IPTV playlists. Mark invalid channels and regenerate your M3U8 playlist for verified streams.

- Tags: how-to-guide
- Published: 2026-06-26

### [What [>] and [x] Markers Mean in Free-TV IPTV Channel URLs](/Free-TV/IPTV/iptv-channel-url-markers-explained)

Understand [>] and [x] markers in IPTV channel URLs from Free-TV/IPTV. Learn how these indicators manage active and broken streams for accurate playlist generation.

- Tags: documentation
- Published: 2026-06-26

### [How to Add a New Country or Region to the Free-TV IPTV Playlist](/Free-TV/IPTV/how-to-add-new-country-to-iptv-playlist)

Learn how to add a new country to the Free-TV IPTV playlist. Create a Markdown list, update the script, and regenerate your M3U files easily for a comprehensive channel list.

- Tags: how-to-guide
- Published: 2026-06-26

### [How to Add a New Channel to the Free-TV/IPTV Playlist](/Free-TV/IPTV/how-to-add-new-iptv-channel)

Quickly add a new channel to your Free-TV/IPTV playlist by editing the country-specific Markdown file and committing changes. Learn the simple process now.

- Tags: how-to-guide
- Published: 2026-06-26

### [How to Update Broken or Invalid Stream URLs in the Free-TV IPTV Repository](/Free-TV/IPTV/workflow-for-updating-broken-stream-urls)

Quickly update broken Free TV IPTV stream URLs. Learn the simple markdown editing workflow to exclude invalid channels from your playlist without touching Python scripts.

- Tags: how-to-guide
- Published: 2026-06-17

### [How Free-TV/IPTV Ensures UTF-8 Encoding for Output Playlist Files](/Free-TV/IPTV/ensuring-utf-8-encoding-for-playlist-files)

Learn how Free-TV/IPTV ensures UTF-8 encoding for output playlist files by setting encoding='utf-8' in all file operations for reliable character display.

- Tags: how-to-guide
- Published: 2026-06-17

### [How h1 and h2 HTML Tags Define Channel Group Hierarchy in Free-TV IPTV Markdown](/Free-TV/IPTV/h1-h2-html-tags-for-channel-group-hierarchy)

Understand how h1 and h2 HTML tags structure channel group hierarchy in Free-TV IPTV markdown. Learn to define countries and broadcast standards for M3U8 playlists.

- Tags: how-to-guide
- Published: 2026-06-17

### [How Free-TV/IPTV Handles Missing or Zero Channel Numbers: A Complete Guide](/Free-TV/IPTV/handling-missing-or-zero-channel-numbers)

Learn how Free-TV/IPTV handles missing channel numbers. Discover how the M3U playlist omits tvg-chno for zero or missing numbers, preventing invalid placeholders.

- Tags: how-to-guide
- Published: 2026-06-17

### [What Is the group-title Attribute in M3U8 for Channel Categorization?](/Free-TV/IPTV/m3u8-group-title-attribute-functionality)

Learn how the M3U8 group-title attribute categorizes IPTV channels for better organization. Improve your channel navigation with this essential guide.

- Tags: deep-dive
- Published: 2026-06-17

### [How Free-TV/IPTV Parses Markdown Table Columns Separated by Pipe Characters](/Free-TV/IPTV/parsing-markdown-table-columns-with-pipes)

Learn how the Free-TV/IPTV script parses markdown table columns. Discover how it splits pipe-delimited data and extracts channel information efficiently.

- Tags: how-to-guide
- Published: 2026-06-17

### [Difference Between Aggregated playlist.m3u8 and Individual Country Playlists](/Free-TV/IPTV/difference-between-aggregated-and-country-playlists)

Understand the difference between the aggregated playlist.m3u8 and individual country playlists. Optimize your IPTV experience with region-specific channel lists for faster loading and reduced data usage. Explore Free-TV/IPTV now.

- Tags: deep-dive
- Published: 2026-06-17

### [How Are EPG IDs (tvg-id) Assigned for Electronic Program Guide Integration in the Free-TV/IPTV Repository](/Free-TV/IPTV/how-epg-ids-are-assigned-for-guide-integration)

Learn how Free-TV/IPTV assigns EPG IDs (tvg-id) by extracting them from markdown channel tables and parsing them into M3U playlists with the Channel class.

- Tags: how-to-guide
- Published: 2026-06-17

### [How to Add a New Country or Region to the Free-TV IPTV Playlist](/Free-TV/IPTV/process-for-adding-new-country-to-playlist)

Learn how to add a new country or region to the Free-TV IPTV playlist. Follow simple steps to update your M3U8 files and expand your TV options.

- Tags: how-to-guide
- Published: 2026-06-17

### [How to Identify Geoblocked Channels in Free-TV/IPTV: The Ⓖ Marker Explained](/Free-TV/IPTV/geoblocked-channel-markers-in-definitions)

Learn how to identify geoblocked channels in Free-TV/IPTV with the circled G Ⓖ marker explained. Discover easy methods to find and bypass region-restricted content in your channel lists.

- Tags: how-to-guide
- Published: 2026-06-17

### [Why Free-TV/IPTV Generates Separate Country-Specific Playlists in the Playlists Directory](/Free-TV/IPTV/purpose-of-country-specific-playlists)

Discover why Free-TV/IPTV creates country-specific playlists. Learn about region-aware filtering and optimized downloads for a better viewing experience.

- Tags: internals
- Published: 2026-06-17

### [How Free-TV/IPTV Handles Different Channel Source Groups: ATSC, Pluto TV, and Beyond](/Free-TV/IPTV/handling-different-channel-source-groups)

Discover how the Free-TV/IPTV script uniformly processes ATSC, Pluto TV, and other channel sources for consistent M3U playlists, ignoring specific group tags.

- Tags: how-to-guide
- Published: 2026-06-17

### [How Channel Numbers (tvg-chno) Are Assigned During Playlist Generation in Free-TV/IPTV](/Free-TV/IPTV/how-channel-numbers-are-assigned-during-playlist-generation)

Discover how Free-TV/IPTV assigns channel numbers (tvg-chno) during playlist generation. Learn how non-empty, non-zero values are extracted and included in your M3U playlists.

- Tags: internals
- Published: 2026-06-17

### [Complete M3U8 File Structure and EXTINF Attributes in Free-TV IPTV](/Free-TV/IPTV/m3u8-file-structure-and-extinf-attributes)

Explore the complete M3U8 file structure generated by Free-TV IPTV. Understand EXTINF attributes, EPG URLs, and channel entries for seamless IPTV playlist creation.

- Tags: deep-dive
- Published: 2026-06-17

### [How the Free-TV/IPTV Script Filters for Valid Channels Using the [>] Marker](/Free-TV/IPTV/how-to-filter-valid-channels-using-marker)

Learn how the Free-TV/IPTV script filters valid channels by checking for the [>] marker. Discover how this ensures only active stream links are processed into M3U playlists.

- Tags: how-to-guide
- Published: 2026-06-17

### [How Channel Logo URLs Are Extracted From Markdown `<img>` Tags in Free-TV/IPTV](/Free-TV/IPTV/how-channel-logo-urls-are-extracted-from-markdown)

Discover how the Free-TV/IPTV repository extracts channel logo URLs from markdown img tags. Learn the precise string manipulation techniques used for efficient data retrieval.

- Tags: how-to-guide
- Published: 2026-06-17

### [What Is flag_order.txt and How Does It Sort Country Flags in Free-TV/IPTV?](/Free-TV/IPTV/role-of-flag-order-txt-in-sorting-country-display)

Discover how flag_order.txt sorts country flags in Free-TV/IPTV. Learn its role in defining display order for optimized country flag presentation.

- Tags: internals
- Published: 2026-06-17

### [How Free-TV/IPTV Loads EPG URLs from epglist.txt into M3U8 Headers](/Free-TV/IPTV/how-epg-urls-are-loaded-and-added-to-m3u8-headers)

Learn how Free-TV/IPTV loads EPG URLs from epglist.txt to enrich your M3U8 headers. Discover the process and enhance your playlist experience.

- Tags: how-to-guide
- Published: 2026-06-17

### [Markdown File Format for Channel Definitions in the Free-TV/IPTV Lists Directory](/Free-TV/IPTV/markdown-file-format-for-channel-definitions)

Discover the HTML-enhanced Markdown format for channel definitions used in Free-TV IPTV lists. Learn about geographic headers, technology sections, and pipe-delimited tables with stream URLs, logos, and EPG.

- Tags: api-reference
- Published: 2026-06-17

### [How the COUNTRY_CODES Dictionary Maps Country Names to ISO Codes in Free-TV/IPTV](/Free-TV/IPTV/country-codes-dictionary-mapping-country-names-to-iso-codes)

Learn how the COUNTRY_CODES dictionary in Free-TV/IPTV maps country names to ISO codes using filename segments as keys and two-letter country codes as values in make_playlist.py.

- Tags: internals
- Published: 2026-06-17

### [Channel Class Structure in Free-TV/IPTV: How It Processes Markdown Table Data](/Free-TV/IPTV/channel-class-structure-and-markdown-table-data-processing)

Understand the Channel class structure in Free-TV/IPTV. Learn how it processes markdown table data to create M3U playlist format for your channels. Explore the make_playlist.py repository.

- Tags: internals
- Published: 2026-06-17

### [How make_playlist.py Parses Markdown to Create M3U8 Playlists in Free-TV/IPTV](/Free-TV/IPTV/how-does-make-playlist-py-parse-markdown-to-create-m3u8-playlists)

Discover how make_playlist.py transforms Markdown into M3U8 playlists for Free-TV/IPTV. Learn its parsing logic for channel data and metadata generation.

- Tags: how-to-guide
- Published: 2026-06-17

### [How Stream URLs Are Validated Before Inclusion in IPTV Playlists](/Free-TV/IPTV/what-validation-is-performed-on-stream-urls-before-inclusion-in-iptv-playlists)

Discover how the Free-TV/IPTV repository validates stream URLs for playlists. Learn about the minimal checks performed on protocols, hostnames, and reachability.

- Tags: how-to-guide
- Published: 2026-06-16

### [How the Free-TV/IPTV Script Handles Missing or Null EPG IDs in Channel Data](/Free-TV/IPTV/how-does-the-iptv-script-handle-missing-or-null-epg-ids-in-channel-data)

Learn how the Free-TV/IPTV script manages missing EPG IDs by setting them to None and omitting the tvg-id field for cleaner channel data.

- Tags: how-to-guide
- Published: 2026-06-16

### [What Determines the Ordering of Channels Within Each Country IPTV Playlist?](/Free-TV/IPTV/what-determines-the-ordering-of-channels-within-each-country-iptv-playlist)

Discover what determines the channel order in country IPTV playlists. Learn how the sequence in markdown list files dictates your channel lineup.

- Tags: internals
- Published: 2026-06-16

### [How the Free-TV/IPTV Script Handles Duplicate Channel Entries Across Different Sources](/Free-TV/IPTV/how-does-the-iptv-script-handle-duplicate-channel-entries-across-different-sources)

Discover how the Free-TV/IPTV script manages duplicate channel entries by leaving deduplication to manual curation. Learn more about its robust handling of diverse sources.

- Tags: how-to-guide
- Published: 2026-06-16

### [How Channel Names with Special Characters Are Escaped in IPTV M3U8 Output](/Free-TV/IPTV/how-are-channel-names-with-special-characters-escaped-in-iptv-m3u8-output)

Learn how channel names with special characters are preserved verbatim in IPTV M3U8 tvg-name attributes, following standard parsing rules for accurate playback.

- Tags: how-to-guide
- Published: 2026-06-16

### [Structure of epglist.txt and How It Is Processed in IPTV](/Free-TV/IPTV/what-is-the-structure-of-the-epglist-txt-file-and-how-is-it-processed-in-iptv)

Learn the structure of epglist.txt and how make_playlist.py processes it to create M3U8 playlists with the x-tvg-url attribute for IPTV.

- Tags: how-to-guide
- Published: 2026-06-16

### [What Determines tvg-chno Channel Numbering in Free-TV/IPTV M3U8 Output](/Free-TV/IPTV/what-determines-the-channel-numbering-assignment-in-the-iptv-m3u8-output)

Discover how tvg-chno channel numbering is determined in Free-TV IPTV M3U8 output. Learn how attributes are extracted from source Markdown files to define channel order.

- Tags: internals
- Published: 2026-06-16

### [How are channel logos resolved and embedded in M3U8 metadata for IPTV?](/Free-TV/IPTV/how-are-channel-logos-resolved-and-embedded-in-m3u8-metadata-for-iptv)

Learn how Free-TV/IPTV embeds channel logos in M3U8 metadata. Discover the simple extraction from HTML img tags and direct insertion as tvg-logo attributes.

- Tags: how-to-guide
- Published: 2026-06-16

### [How Free-TV/IPTV Handles HD vs SD Channel Designation Using the Ⓢ Marker](/Free-TV/IPTV/how-does-the-iptv-playlist-handle-hd-vs-sd-channel-designation-using-the-s-marker)

Learn how Free-TV/IPTV designates HD vs SD channels using the circled S marker. Discover how unmarked channels are recognized as HD.

- Tags: how-to-guide
- Published: 2026-06-16

### [How the Free-TV IPTV Script Handles Valid vs Invalid Channel URLs in Playlists](/Free-TV/IPTV/how-does-the-iptv-script-handle-valid-vs-invalid-channel-urls-in-playlists)

Learn how the Free-TV IPTV script effectively filters valid channel URLs [>] from invalid ones [x] in playlists, ensuring a clean M3U output.

- Tags: how-to-guide
- Published: 2026-06-16

### [How to Extract and Validate Stream URLs from Markdown Tables in IPTV Data](/Free-TV/IPTV/how-does-the-script-extract-and-validate-stream-urls-from-markdown-tables-in-iptv-data)

Learn how the Free-TV/IPTV script extracts and validates stream URLs from markdown tables. It parses URLs and metadata to create standardized M3U8 playlists.

- Tags: how-to-guide
- Published: 2026-06-16

### [How Channel Groups ATSC, DVB-S, and Pluto Are Organized in Markdown Files](/Free-TV/IPTV/how-are-channel-groups-like-atsc-dvb-s-and-pluto-organized-in-markdown-files)

Discover how Free-TV/IPTV organizes ATSC DVB-S and Pluto channel groups in markdown. Learn about the file structure and table format for stream URLs and metadata.

- Tags: internals
- Published: 2026-06-16

### [Internal Architecture of the Channel Class in Free-TV/IPTV](/Free-TV/IPTV/what-is-the-internal-architecture-of-the-channel-class-in-free-tv-iptv)

Explore the internal architecture of the Channel class in Free-TV/IPTV. Understand its three-part structure for converting Markdown to M3U playlist lines, handling metadata like EPG IDs and country codes.

- Tags: architecture
- Published: 2026-06-16

### [How the Free-TV IPTV Playlist Generator Handles EPG Integration with External Providers](/Free-TV/IPTV/how-does-the-iptv-playlist-generator-handle-epg-integration-with-external-providers)

Learn how the Free-TV IPTV playlist generator integrates external EPG providers by reading URLs and embedding them into M3U playlists for seamless TV guide functionality.

- Tags: how-to-guide
- Published: 2026-06-16

### [How Country Codes Are Mapped and Applied to Channels in IPTV Playlist Generation](/Free-TV/IPTV/how-are-country-codes-mapped-and-applied-to-channels-in-iptv-playlist-generation)

Discover how country codes map to IPTV channels in playlist generation. Learn about ISO-3166-1 alpha-2 codes and tvg-country attributes in M3U playlists generated by Free-TV/IPTV.

- Tags: how-to-guide
- Published: 2026-06-16

### [How make_playlist.py Parses Markdown Channel Data into M3U8 Format](/Free-TV/IPTV/how-does-make_playlist-py-parse-markdown-channel-data-into-m3u8-format)

Discover how make_playlist.py transforms Markdown channel data into M3U8 playlists by parsing pipe-delimited tables and serializing EXTINF entries with TVG metadata. Learn more now.

- Tags: how-to-guide
- Published: 2026-06-16