IPTV Playlist Project

Welcome to the IPTV project! This repository offers a curated collection of free TV playlists for IPTV players, providing access to various channels from around the world.

Table of Contents

1. Introduction
2. Philosophy
3. Installation & Usage
4. Feed Sources
5. Format
6. Contributing
7. Pull Requests
8. License

Either free locally (over the air):

Or free on the Internet:

• Plex TV
• Pluto TV (English, Spanish, French, Italian)
• Redbox Live TV
• Roku TV
• Samsung TV Plus
• Youtube live channels

To use it point your IPTV player to https://raw.githubusercontent.com/Free-TV/IPTV/master/playlist.m3u8.

Introduction

This project provides a collection of free IPTV playlists, allowing users to stream live TV channels thorugh compatible IPTV players. The playlists are community-driven, regularly updated, and intended for users looking for a wide range of channels.Channels are free-to-air or sourced from free online platforms, ensuring that users only access legal content.

Philosophy

The main goals for this playlist are listed below.

Quality over quantity

The less channels we support the better.

• All channels should work well.
• As much as possible channels should be in HD, not SD.
• Only one URL per channel (no +1, no alternate feeds, no regional declinations)

Only free channels

If a channel is normally only available via commercial subscriptions it has nothing to do in this playlist. If on the other hand it is provided for free to everybody in a particular country, then it should be in this playlist.

• No paid channels
• Only channels which are officially provided for free (via DVB-S, DVB-T, analog, etc..)

Only mainstream channels

This is a playlist for everybody.

• No adult channels
• No channels dedicated to any particular religion
• No channels dedicated to any particular political party
• No channels made for a country and funded by a different country

Installation and Usage

To use playlists

1. Download or clone this repository
2. Use any IPTV player (e.g. VLC, Kodi, IPTV Smarters) to load the '.m3u' file or copy the URL into your player.

Reccomended Players:

• VLC Media Player
• Kodi
• IPTV Smarters

How to Use:

1. Open your IPTV player. Import the playlist file or URL. Start streaming live TV channels!

Feed sources

Finding up-to-date URLs can be difficult. Here are some useful sources:

• https://github.com/iptv-org/iptv/tree/master/streams
• Live streams from platforms like YouTube and Dailymotion, ensuring the stream is active and stable.

Format

The m3u8 playlist is generated by make_playlist.py, using the .md files in the lists directory.

Each .md file represesnts a group. The <h1> line is used as the group title.

Only channels which URL column starts with [>] are included in the playlist.

Channels which are not in HD are marked with an Ⓢ.

Channels which use GeoIP blocking are marked with a Ⓖ.

Channels which are live Youtube channels are marked with a Ⓨ.

Issues

Only create issues for bugs and feature requests.

Do not create issues for adding, editing, or removing channels. For these, please submit a pull request.

Contributing

Contributions are welcome! To contribute:

1. Fork the repository.
2. Create a new branch for your changes.
3. Submit a pull request with your updates.

Pull Requests

Only modify .md files

If your Pull Request modifies channels, only modify .md files. Do not modify m3u8 files in your pull request.

Adding a new Channel

To add a new channel, make a Pull Request.

• In your Pull Request you need to provide information to show that the channel is free.
• Use imgur.com to host the channel logo and point to it.
• If you have a valid stream, add it and put [>] in front of it.
• If you don't have an stream for the channel, add [x]() in the url column and place your channel in the Invalid category.
• If you have a stream but it doesn't work well, put the channel in the Invalid category and put [x] in front of the url.
• If you're adding geoblocked URLs specify it in your PR and specify which country they're working in. The PR will only be merged if these URLs can be tested.

Removing a Channel

• To remove a channel, make a Pull Request.

• In your Pull Request you need to provide information to show that the channel is only available via a private paid subscription.

• Note: Public taxes (whether national or regional, whether called TV License or not) do not constitute a private paid subscription.

• If a stream is broken, simply move the channel to the invalid category and replace [>] with [x] in the url column.

License

This project currently does not have a license. Please clarify the licensing terms before using or contributing.