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.

### 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                 | 432      | `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`.