iptv/README.md

# IPTV

Collection of 6000+ free IPTV channels from all over the world.

## Usage

### VLC Player

To open the playlist in VLC player you just need click `File` - > `Open Network...` and in the window that opens, insert a link to the playlist itself: `https://raw.githubusercontent.com/freearhey/iptv/master/index.m3u`

![VLC Network Panel](https://github.com/freearhey/iptv/raw/master/preview.png)

then just press the 'Open' button

### Android

To watch IPTV on your Android device you can use any player with support M3U-playlists and this playlist: [https://raw.githubusercontent.com/freearhey/iptv/master/index.all.m3u](https://raw.githubusercontent.com/freearhey/iptv/master/index.all.m3u). Or select a playlist for a specific country from the list below.

### iOS

To watch IPTV on your iOS device you can use [Movie Stream - M3U IP TV Films](https://itunes.apple.com/us/app/movie-stream-ip-tv-films/id1450912244?mt=8) or any other IPTV player with support M3U-playlists and this playlist
[All Sources](https://raw.githubusercontent.com/freearhey/iptv/master/index.all.m3u). Or select a playlist for a specific country from the list below.

### Plex App

In order to watch IPTV through Plex App, you can use the [Cigaras/IPTV.bundle](https://github.com/Cigaras/IPTV.bundle) plugin.

## Playlists by country

| Country                | Channels | Playlist 
| ---------------------- | -------: | --------
| Afghanistan            | 5        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/af.m3u`
| Albania                | 16       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/al.m3u`
| Algeria                | 11       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/dz.m3u`
| Argentina              | 89       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ar.m3u`
| Armenia                | 23       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/am.m3u`
| Australia              | 29       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/au.m3u`
| Austria                | 11       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/at.m3u`
| Azerbaijan             | 4        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/az.m3u`
| Bahrain                | 9        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/bh.m3u`
| Bangladesh             | 0        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/bd.m3u`
| Barbados               | 2        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/bb.m3u`
| Belarus                | 16       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/by.m3u`
| Belgium                | 11       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/be.m3u`
| Bolivia                | 17       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/bo.m3u`
| Bosnia and Herzegovina | 16       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ba.m3u`
| Brazil                 | 75       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/br.m3u`
| Bulgaria               | 26       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/bg.m3u`
| Cambodia               | 9        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/kh.m3u`
| Canada                 | 41       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ca.m3u`
| Chile                  | 77       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/cl.m3u`
| China                  | 1420     | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/cn.m3u`
| Colombia               | 16       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/co.m3u`
| Costa Rica             | 15       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/cr.m3u`
| Croatia                | 33       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/hr.m3u`
| Cuba                   | 2        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/cu.m3u`
| Cyprus                 | 10       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/cy.m3u`
| Czech Republic         | 17       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/cz.m3u`
| Democratic Republic of the Congo | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/cd.m3u`
| Denmark                | 8        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/dk.m3u`
| Dominican Republic     | 23       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/do.m3u`
| Ecuador                | 18       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ec.m3u`
| Egypt                  | 16       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/eg.m3u`
| El Salvador            | 3        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/sv.m3u`
| Equatorial Guinea      | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/gq.m3u`
| Estonia                | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ee.m3u`
| Finland                | 2        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/fi.m3u`
| France                 | 75       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/fr.m3u`
| Georgia                | 6        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ge.m3u`
| Germany                | 115      | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/de.m3u`
| Ghana                  | 3        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/gh.m3u`
| Greece                 | 32       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/gr.m3u`
| Guatemala              | 0        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/gt.m3u`
| Guinea                 | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/gn.m3u`
| Guyana                 | 2        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/gy.m3u`
| Haiti                  | 9        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ht.m3u`
| Honduras               | 12       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/hn.m3u`
| Hong Kong              | 23       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/hk.m3u`
| Hungary                | 7        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/hu.m3u`
| Iceland                | 4        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/is.m3u`
| India                  | 198      | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/in.m3u`
| Indonesia              | 146      | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/id.m3u`
| Iran                   | 15       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ir.m3u`
| Iraq                   | 16       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/iq.m3u`
| Ireland                | 4        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ie.m3u`
| Israel                 | 19       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/il.m3u`
| Italia                 | 175      | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/it.m3u`
| Ivory Coast            | 2        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ci.m3u`
| Jamaica                | 7        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/jm.m3u`
| Japan                  | 21       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/jp.m3u`
| Jordan                 | 13       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/jo.m3u`
| Kazakhstan             | 42       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/kz.m3u`
| Kenya                  | 3        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ke.m3u`
| Kosovo                 | 5        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/xk.m3u`
| Kuwait                 | 26       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/kw.m3u`
| Kyrgyzstan             | 6        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/kg.m3u`
| Latvia                 | 9        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/lv.m3u`
| Lebanon                | 17       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/lb.m3u`
| Libya                  | 10       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ly.m3u`
| Luxembourg             | 2        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/lu.m3u`
| Macau                  | 8        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/mo.m3u`
| Macedonia              | 5        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/mk.m3u`
| Malaysia               | 17       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/my.m3u`
| Malta                  | 4        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/mt.m3u`
| Mexico                 | 60       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/mx.m3u`
| Moldova                | 16       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/md.m3u`
| Mongolia               | 0        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/mn.m3u`
| Montenegro             | 0        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/me.m3u`
| Morocco                | 12       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ma.m3u`
| Mozambique             | 3        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/mz.m3u`
| Myanmar                | 2        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/mm.m3u`
| Nepal                  | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/np.m3u`
| Netherlands            | 37       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/nl.m3u`
| New Zealand            | 10       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/nz.m3u`
| Nicaragua              | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ni.m3u`
| Nigeria                | 6        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ng.m3u`
| Norway                 | 5        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/no.m3u`
| Oman                   | 9        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/om.m3u`
| Pakistan               | 23       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/pk.m3u`
| Palestine              | 7        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ps.m3u`
| Panama                 | 5        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/pa.m3u`
| Paraguay               | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/py.m3u`
| Peru                   | 24       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/pe.m3u`
| Philippines            | 2        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ph.m3u`
| Poland                 | 9        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/pl.m3u`
| Portugal               | 51       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/pt.m3u`
| Puerto Rico            | 3        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/pr.m3u`
| Qatar                  | 29       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/qa.m3u`
| Romania                | 39       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ro.m3u`
| Russia                 | 428      | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ru.m3u`
| Rwanda                 | 2        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/rw.m3u`
| Saint Kitts and Nevis  | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/kn.m3u`
| San Marino             | 0        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/sm.m3u`
| Saudi Arabia           | 39       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/sa.m3u`
| Serbia                 | 8        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/rs.m3u`
| Singapore              | 9        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/sg.m3u`
| Slovakia               | 12       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/sk.m3u`
| Slovenia               | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/si.m3u`
| South Korea            | 36       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/kr.m3u`
| Spain                  | 119      | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/es.m3u`
| Sri Lanka              | 9        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/lk.m3u`
| Sudan                  | 6        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/sd.m3u`
| Sweden                 | 3        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/se.m3u`
| Switzerland            | 11       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ch.m3u`
| Syria                  | 17       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/sy.m3u`
| Taiwan                 | 52       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/tw.m3u`
| Thailand               | 42       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/th.m3u`
| Trinidad and Tobago    | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/tt.m3u`
| Tunisia                | 5        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/tn.m3u`
| Turkey                 | 90       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/tr.m3u`
| Turkmenistan           | 7        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/tm.m3u`
| Ukraine                | 217      | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ua.m3u`
| United Arab Emirates   | 72       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ae.m3u`
| United Kingdom         | 28       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/uk.m3u`
| United States          | 433      | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/us.m3u`
| Uruguay                | 21       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/uy.m3u`
| Uzbekistan             | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/uz.m3u`
| Venezuela              | 10       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ve.m3u`
| Vietnam                | 66       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/vn.m3u`
| Yemen                  | 9        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ye.m3u`


## Contribution

The easiest way to help the project is to sort channels by country. Specifically for this was created playlist `channels/unsorted.m3u` which contains channels that are not yet sorted by other playlists. If you recognize one of the channels in this playlist, just copy its title and link to the desired country playlist. That's it!

If you want to add new channel to the playlist you need add link to stream and some information about it. For example:

```xml
#EXTINF:-1 tvg-id="exampletv.us" tvg-name="Example TV" tvg-logo="http://example.com/channel-logo.png" group-title="News",Example TV
http://example.com/stream.m3u8
```

| Attribute   | Description
| ----------- | ---
| tvg-id      | Unique channel id that is used to load EPG. Here you can find id for most channels: https://xtream-editor.com/en/epg (optional)
| tvg-name    | Official channel name. In most cases, you can use the name listed here: https://xtream-editor.com/en/epg (optional)
| tvg-logo    | Logo of the channel from http://www.tv-logo.com/ (optional)
| group-title | One of the following categories: Auto, Business, CCTV, Entertainment, Food, General, Hobby, Kids, Local, Movies, Music, News, Religious, Shop, Sport, Travel, XXX (optional)

If you just found an error or have any suggestions on how to organize a playlist please send an [issue](https://github.com/freearhey/iptv/issues) or a [pull request](https://github.com/freearhey/iptv/pulls)


## Testing

```sh
npm run test
```

Be prepared test may take a long time. After the tests end all broken links will be saved to the file `error.log`.