LiveTVCollector

A GitHub repository that automatically collects, filters, and exports live TV streaming links for Country/Category wise using GitHub Actions. This project fetches M3U playlists from multiple sources, removes duplicates, verifies active links, and exports them into various formats under the LiveTV/Country Name/ directory.

📊 Project Stats

!

Online Useable Tools:

Features

• Automated Updates: Runs every 8 hours (approximately 05:30, 13:30, 21:30 IST) via GitHub Actions.
• Large Source Handling: Processes large M3U files efficiently with streaming to minimize memory usage.
• Active Link Verification: Checks links for availability using concurrent requests (50 workers).
• Duplicate Removal: Ensures no duplicate streams (based on URL) are included.
• HTML Source Parsing: Extracts streaming URLs from HTML pages, filtering out non-stream links (e.g., Telegram, GitHub).
• Multiple Export Formats:

Exported File Formats

LiveTV.m3u

#EXTM3U
#EXTINF:-1 tvg-logo="https://i.imgur.com/VQVr4Nk.png" group-title="Entertainment",Adventure TV
http://109.233.89.170/Adventure_HD/index.m3u8

LiveTV.txt

Group: Entertainment
Name: Adventure TV
URL: http://109.233.89.170/Adventure_HD/index.m3u8
Logo: https://i.imgur.com/VQVr4Nk.png
Source: https://example.com/source.m3u
--------------------------------------------------

LiveTV.json

{
  "date": "2025-03-25 13:30:00",
  "channels": {
    "Entertainment": [
      {
        "name": "Adventure TV",
        "logo": "https://i.imgur.com/VQVr4Nk.png",
        "group": "Entertainment",
        "source": "https://example.com/source.m3u",
        "url": "http://109.233.89.170/Adventure_HD/index.m3u8"
      }
    ]
  }
}

LiveTV (Custom Format)

[
  {
    "name": "Adventure TV",
    "type": "Entertainment",
    "url": "http://109.233.89.170/Adventure_HD/index.m3u8",
    "img": "https://i.imgur.com/VQVr4Nk.png"
  }
]

Setup Instructions

Prerequisites

• A GitHub account and repository (bugsfreeweb/LiveTVCollector).
• No local setup required; everything runs via GitHub Actions.

Steps

1. Clone or Fork:

git clone https://github.com/bugsfreeweb/LiveTVCollector.git
   cd LiveTVCollector

1. Customize Sources (Optional):

1. Push Changes:

git add .
   git commit -m "Initial setup or source update"
   git push origin main

1. Verify Workflow:

How It Works

1. Source Fetching:

1. Processing:

1. Exporting:

1. Automation:

Dependencies

Managed by GitHub Actions:

• requests: For fetching M3U and HTML content.
• pytz: For Mumbai timezone timestamps.
• beautifulsoup4: For HTML parsing.

pip install requests pytz beautifulsoup4

Troubleshooting

• Empty Files: Check the Actions logs for errors:

• Permissions Error: Ensure permissions: contents: write is in Country Name.yml.

• Logs: View detailed logs in the "Actions" tab to diagnose issues.

Contributing

Feel free to:

• Add more Country Name-specific sources to BugsfreeMain/CountryName.py.
• Suggest improvements via issues or pull requests.

License

This project is open-source and available under the MIT License (add a LICENSE file if desired).

Disclaimer

This project is intended solely for educational and research purposes. It aggregates publicly available streaming links from various sources on the internet for convenience and does not host, distribute, or provide any streaming content itself. The maintainers of this repository are not affiliated with the content providers or the streams listed in the exported files.

• Usage Responsibility: Users are responsible for ensuring their use of the streaming links complies with local laws and regulations, including copyright and intellectual property rights.
• No Warranty: The links provided are sourced from third-party repositories and may become unavailable or change without notice. This project offers no guarantee regarding the availability, quality, or legality of the streams.
• Content Ownership: All streaming content belongs to its respective owners, and this project does not claim ownership or endorse any specific content.

Usage Policy

• Personal Use Only: These files are intended for personal, non-commercial use.
• No Redistribution for Profit: Do not redistribute or sell these files for commercial purposes.
• Respect Source Terms: Adhere to the terms of service of the original stream providers.
• Attribution: If you share or use this data, please credit bugsfreeweb/LiveTVCollector.
• Modification: Feel free to modify the files for personal use, but do not misrepresent them as official or endorsed content.

Donate the project

• DOGE: DEtH2yFUjjUEBUyd3scjs38X7S1Z7ee7zD
• BTC Lightening: [email protected]
• SOL: bugsfree.sol