Leer en Español

Teleonline - Curated TV Lists

Teleonline maintains curated lists of publicly available television channels from around the world (official sources only). These lists group together free-to-air (FTA) channels that are legally available to the general public.

Table of Contents

• Contents
• Data Structure
• Field Definitions
• M3U8 Playlist
• How to Use
• Legal Compliance
• Updates & Maintenance
• Contributing
• Disclaimer
• License

Contents

This repository contains:

• tv.json - Television channels organized by country and scope
• tv.m3u8 - M3U8 playlist format for media players

All channels listed are:

• ✓ Publicly broadcast channels
• ✓ Free-to-air (FTA) without subscription requirements
• ✓ Legally distributed by their respective broadcasters
• ✓ Accessible within their designated broadcast regions

Data Structure

tv.json

{
  "countries": [
    {
      "name": "Country Name",
      "ambits": [
        {
          "name": "Category",
          "channels": [
            {
              "name": "Channel Name",
              "logo": "https://example.com/logo.png",
              "web": "https://example.com/",
              "epg_id": "channel.id",
              "options": [
                {
                  "format": "hls",
                  "url": "https://stream.example.com/master.m3u8"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

Field Definitions

Field	Type	Description
name	string	Channel name
logo	string	Logo/image URL
web	string	Official website
epg_id	string	Electronic Program Guide identifier
options	array	Available streaming options
format	string	Stream format (hls, dash, youtube, web)
url	string	Stream URL

M3U8 Playlist

The tv.m3u8 file is automatically generated from tv.json and contains:

• Channel metadata (name, logo, EPG ID)
• Stream URLs
• Group categorization by country and scope

Compatible with:

• VLC Media Player
• Kodi
• OBS Studio
• IPTV Player apps
• Other IPTV-compatible clients

How to Use

Direct Access

Access the raw files directly for integration:

TV JSON:

https://raw.githubusercontent.com/teleonline/listas/main/tv.json

TV M3U8:

https://raw.githubusercontent.com/teleonline/listas/main/tv.m3u8

Use Cases

1. Media Players

Add the M3U8 URL to your media player:

• VLC: Media → Open Network Stream → Paste M3U8 URL
• Kodi: Add-ons → Install from Repository → Enter M3U8 URL
• OBS: Scene → Add Source → Media Source → Enter M3U8 URL

2. Custom Applications

Use tv.json to build custom apps:

• Create IPTV applications
• Build channel recommendation systems
• Develop EPG integrations
• Create smart TV apps

3. Playlist Management

Import M3U8 into playlist managers:

• IPTV Smarters
• Perfect Player
• GSE Smart IPTV
• Televizo

4. Web Integration

Embed streams in web applications using JSON data with HLS.js or similar libraries

5. Backup & Archive

Keep local copies of channels and metadata for offline access

Legal Compliance

What We Include

Only channels that meet these criteria:

1. Legally Distributed - Officially broadcast and publicly available
2. No DRM Bypass - No circumvention of copyright protection mechanisms
3. Regional Respect - Geographic restrictions are properly applied
4. Proper Attribution - Credit given to original broadcasters

What We Don't Include

• Unauthorized or pirated streams
• Subscription-protected channels
• DRM-circumvented content
• Illegally redistributed broadcasts

External Use

If you use these lists externally, you agree to:

1. Respect all geographic and licensing restrictions
2. Comply with local broadcast regulations
3. Use streams only in permitted regions
4. Follow broadcaster terms of service

Updates & Maintenance

Lists are maintained through:

• Community contributions
• Broadcaster API monitoring
• Regular stream availability validation
• Removal of broken or obsolete streams

Contributing

To contribute updates or corrections:

1. Verify the channel is legally available FTA in its broadcast region
2. Include working stream URLs and accurate metadata
3. Test streams function correctly
4. Submit updates with clear documentation

Disclaimer

Teleonline provides lists "as-is" for informational and legal use only. Users are responsible for:

• Complying with local broadcast laws
• Respecting broadcaster terms of service
• Understanding regional content restrictions
• Using streams only in permitted geographic regions

Teleonline does NOT:

• Host or distribute any streams directly
• Circumvent DRM or copyright protections
• Facilitate unauthorized access to paid content
• Guarantee availability or reliability of streams

License

These lists are provided solely for legal informational purposes. By using these lists, you acknowledge you will use them in compliance with all applicable laws and broadcaster terms of service.

---

Last Updated: Automatically maintained