iptv/README.md

# IPTV

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

## Usage

To watch IPTV you just need to paste this link `https://raw.githubusercontent.com/freearhey/iptv/master/index.m3u` to any player with support M3U-playlists.

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

Below you can find a manually selected list of such applications for different platforms.

### Windows

- [VLC for Windows](https://www.videolan.org/vlc/download-windows.html) is a free and open source cross-platform multimedia player and framework that plays most multimedia files as well as DVDs, Audio CDs, VCDs, and various streaming protocols.

### Mac

- [VLC for Mac OS X](https://www.videolan.org/vlc/download-macosx.html) is a free and open source cross-platform multimedia player and framework that plays most multimedia files as well as DVDs, Audio CDs, VCDs, and various streaming protocols.

### iOS

- [Stream - Watch IPTV & Movies](https://itunes.apple.com/us/app/movie-stream-ip-tv-films/id1450912244?mt=8)

### PlayStation 4

- [Plex](https://www.plex.tv/apps-devices/#modal-devices-playstation-4) media server allows you to aggregate all your personal media and access it anywhere you go. In order to watch IPTV through Plex App, you can use the [Cigaras/IPTV.bundle](https://github.com/Cigaras/IPTV.bundle) plugin.

If the app does not support nested playlists you can instead use a special "all in one" playlist: `https://raw.githubusercontent.com/freearhey/iptv/master/index.all.m3u`

## 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                 | 37       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ca.m3u`
| Chile                  | 77       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/cl.m3u`
| China                  | 1009     | `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                 | 81       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/fr.m3u`
| Georgia                | 6        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ge.m3u`
| Germany                | 138      | `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                  | 225      | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/in.m3u`
| Indonesia              | 203      | `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                 | 263      | `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`
| Laos                   | 4        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/la.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`
| Maldives               | 4        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/mv.m3u`
| Malta                  | 4        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/mt.m3u`
| Mexico                 | 57       | `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                 | 482      | `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`
| Somalia                | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/so.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                 | 97       | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/tr.m3u`
| Turkmenistan           | 7        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/tm.m3u`
| Uganda                 | 1        | `https://raw.githubusercontent.com/freearhey/iptv/master/channels/ug.m3u`
| Ukraine                | 195      | `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          | 505      | `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                | 135      | `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,  Classic, Comedy, Documentary, Education, Entertainment,  Family, Fashion, Food,  General,  Health,  History,  Hobby,  Kids,  Legislative, Lifestyle, Local,  Movies,  Music,  News,  Quiz, Radio,  Religious, Sci-Fi,  Shop,  Sport,  Travel,  Weather,  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. Or if you want to test the playlist of a particular country, you can specify the [ISO 3166 code](https://en.wikipedia.org/wiki/ISO_3166) of the country as an argument when running the test.

```sh
npm run test --country=uk
```

After the test is over all broken links will be saved to the file `error.log`.