Skip to content

📝 Optimize README: Add badges, TOC, and structure #9

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.

Sign up for GitHub

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

Open
Gingiris wants to merge 1 commit into
base: default
Choose a base branch
from
Open

📝 Optimize README: Add badges, TOC, and structure #9

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
70 changes: 70 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,70 @@
# IPTV Stream Monitor

> 📺 Public IPTV channels with automated status monitoring

A curated collection of publicly accessible IPTV streams, featuring real-time channel availability tracking and automated testing.

## ⚡ Quick Start

```bash
# Clone the repository
git clone https://github.com/doms9/iptv.git

# Open M3U file in your preferred IPTV player
# Recommended players: VLC, IPTV Smarters, Perfect Player
```

## 📡 Stream URLs

| Type | URL | Description |
|------|-----|-------------|
| **Base** | `https://s.id/d9Base` | Main channel lineup |
| **Live Events** | `https://s.id/d9Live` | Sports & special events |
| **Combined** | `https://s.id/d9M3U8` | All channels merged |
| **EPG Guide** | `https://s.id/d9sEPG` | Electronic Program Guide |

## ✅ Current Status

| Metric | Count |
|--------|-------|
| Working Streams | 157 |
| Dead Streams | 5 |
| Total Channels | 162 |

### Recent Issues

| Channel | Error Code | Status |
|---------|------------|--------|
| FDSN Ohio | HTTP 403 | ❌ Blocked |
| HBO Family | HTTP 403 | ❌ Blocked |
| Hallmark Family | HTTP 403 | ❌ Blocked |
| NFL Network | HTTP 404 | ❌ Not Found |
| NHL Network | HTTP 000 | ❌ Timeout |

## 🔧 Features

- 📊 **Real-time Monitoring** — Automated status checks every 24 hours
- 🎯 **Multiple Formats** — M3U playlists for all major IPTV players
- 📺 **EPG Integration** — XMLTV guide data included
- 🌍 **Global Coverage** — Sports, news, entertainment channels
- 🔄 **Daily Updates** — Fresh stream URLs and status reports

## 📂 Mirrors

- [GitHub](https://github.com/doms9/iptv)
- [GitLab](https://gitlab.com/doms9/iptv)
- [Forgejo](https://forgejo.mxnticek.eu/doms/iptv)

## ⚠️ Disclaimer

This repository lists publicly accessible IPTV streams as found on the internet at the time of checking. No video or audio content is hosted in this repository. These links may point to copyrighted material owned by third parties; they are provided **solely for educational and research purposes**. The author does not endorse, promote, or encourage illegal streaming or copyright infringement. End users are solely responsible for ensuring they comply with all applicable laws in their jurisdiction before using any link in this repository. If you are a rights holder and wish for a link to be removed, please open an issue.

## 🤝 Contributing

1. Fork the repository
2. Create a feature branch (`git checkout -b new-stream`)
3. Submit a pull request with working stream URLs

---

*README optimized with [Gingiris README Generator](https://gingiris.github.io/github-readme-generator/)*