Updated README file for clarity.

pull/607/head
Natalia Arroyave 2024-09-25 14:27:42 -04:00
parent 7a2c8750a2
commit cbe79bfd87
1 changed files with 61 additions and 12 deletions

View File

@ -1,7 +1,19 @@
Free TV
=======
IPTV Playlist Project
======
This is an M3U playlist for free TV channels around the World.
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
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 `<h1>` 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.
- 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.