Merge cbe79bfd87 into 173030da9b

README.md

@@ -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):
 
@@ -95,6 +107,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
 ==========
 
@@ -124,19 +140,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..)
+- Live streams from platforms like YouTube and Dailymotion, ensuring the stream is active and stable.
-- Dailymotion: Same criteria as for youtube
 
 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.
 
@@ -153,7 +188,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
 =============
@@ -175,10 +219,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.