Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updated README file for clarity. #607

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
73 changes: 61 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
@@ -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):

Expand Down Expand Up @@ -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
==========

Expand Down Expand Up @@ -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.

Expand All @@ -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
=============
Expand All @@ -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.