From cbe79bfd87a7dc4bbea09181dde7b29a43a01aeb Mon Sep 17 00:00:00 2001 From: Natalia Arroyave <116681140+nataliayave@users.noreply.github.com> Date: Wed, 25 Sep 2024 14:27:42 -0400 Subject: [PATCH] Updated README file for clarity. --- README.md | 73 ++++++++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 61 insertions(+), 12 deletions(-) diff --git a/README.md b/README.md index c0cceabfd..972414675 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,19 @@ -Free TV -======= +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 +====== -This is an M3U playlist for free TV channels around the World. +1. Introduction +2. Philosophy +3. Installation & Usage +4. Feed Sources +5. Format +7. Contributing +8. Pull Requests +9. License Either free locally (over the air): @@ -93,6 +105,10 @@ Or free on the Internet: 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 ========== @@ -122,19 +138,38 @@ This is a playlist for everybody. - 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 ============ -It can be quite hard to find up to date URLs, here's a list of sources: +Finding up-to-date URLs can be difficult. Here are some useful sources: - https://github.com/iptv-org/iptv/tree/master/streams -- Youtube: As long as the channel is live and its URL doesn't change (check the age of the stream, the number of viewers..) -- Dailymotion: Same criteria as for youtube +- 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 located in `lists`. +The m3u8 playlist is generated by `make_playlist.py`, using the `.md` files in the `lists` directory. Each .md file represesnts a group. The `

` line is used as the group title. @@ -151,7 +186,16 @@ Issues Only create issues for bugs and feature requests. -Do not create issues to add/edit or to remove channels. If you want to add/edit/remove channels, create a pull request directly. +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 ============= @@ -173,10 +217,15 @@ To add a new channel, make a Pull Request. **Removing a Channel** -To remove a channel, make a Pull Request. +- 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. -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. -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 +====== -If a stream is broken, simply move the channel to the invalid category and replace `[>]` with `[x]` in the url column. +This project currently does not have a license. Please clarify the licensing terms before using or contributing.