📡 Famelack Data

Official public dataset powering Famelack — curated live TV and radio streams from around the world.

What this dataset includes

• Live TV and radio streams from more than 100 countries (IPTV, YouTube Live, direct audio)
• Language, country, and category metadata
• Organized JSON files under tv/ and radio/

Folder structure

tv/
├── compressed/
│   ├── countries/
│   ├── categories/
│   └── countries_metadata.json
└── raw/
    ├── countries/
    ├── categories/
    └── countries_metadata.json

radio/
├── compressed/
│   ├── countries/
│   ├── categories/
│   └── countries_metadata.json
└── raw/
    ├── countries/
    ├── categories/
    └── countries_metadata.json

Metadata files exist in both compressed (gzip) and raw (plain JSON) forms.

How the data is maintained

This dataset is generated by the Famelack ingestion and validation pipeline:

• Stream uptime and reliability checks run regularly
• Broken or non-working streams are removed automatically
• YouTube live channels are verified for embed and live status
• Radio streams are validated for browser playback compatibility
• Newly discovered and verified sources are added continuously
• DMCA and rights-holder requests are respected

If a stream doesn't work reliably, it doesn't stay.

Upstream acknowledgment

Famelack benefits from the open-source community. A significant portion of the TV discovery workflow is sourced from the iptv-org community, which we refine through:

• Automated validation and uptime monitoring
• CORS and playback compatibility checks
• Removal of broken or duplicate streams
• Corrected metadata and standardized country assignment
• Integration of additional verified sources not found upstream

The radio dataset is curated and maintained independently by Famelack, built from multiple publicly accessible sources and validated in-house.

This repository is not a mirror — it is continuously transformed, filtered, and enriched to support the Famelack platform.

About Famelack

This repository powers Famelack.com, which uses this dataset as a primary data source for search, playback, favorites, and other platform features.

➡ https://famelack.com

License and usage

This project is released under the MIT License.

You may use, copy, modify, remix, and build on this data, including commercially.

If you reuse or redistribute this dataset (original or modified), please retain the MIT license and copyright notice. Visible credit is optional but appreciated:

Data sourced from Famelack (famelack.com)

Notes for downstream users

• Schema evolution — JSON field names and structure may change without notice as we optimize for the Famelack platform.
• Hotlinking — Direct access to raw GitHub files may work, but uptime and availability are not guaranteed.
• Stability — For production use, we recommend caching or maintaining your own mirror.

Contact

• DMCA and legal requests: dmca@famelack.com or legal@famelack.com
• General inquiries: hello@famelack.com