Skip to content
MuskTV

Guide · Playlists

How to add an M3U playlist on Android TV

An M3U (or M3U8) playlist is a text file of channel links that your TV provider gives you as a web address. Here is how to load it in MuskTV on Android TV, Google TV or Fire TV, and what to do when it won't load.

Download MuskTVInstall on Fire TV

7-day free trial, then $19.99/year · www.streamusk.com/apk

Add the playlist

  1. Open MuskTV. On the first start the Add playlist screen opens by itself; later, go to Settings › Playlist.
  2. Choose M3U link.
  3. Enter the playlist address exactly as your provider gave it, for example http://example-provider.tv/get.php?username=…&password=…&type=m3u_plus.
  4. Optionally give it a name, and a TV guide link if your provider gave you a separate one (leave it empty to use the guide named inside the playlist).
  5. Select Save. Channels appear as soon as the playlist is read, grouped the way your provider grouped them.

Typing a long address with the remote

  • Many TVs let you type with your phone: on Google TV, use the remote in the Google TV app; on Fire TV, the Fire TV app; both show a phone keyboard when a text field is open.
  • A USB or Bluetooth keyboard works in every text field.
  • Ask your provider for a short link: many offer one, and it's much quicker to type.

What MuskTV reads from the playlist

  • Groups (group-title) become categories.
  • Channel numbers (tvg-chno); without them, the position in the playlist. Each channel keeps one number in every category, and the number keys jump to it.
  • Logos (tvg-logo) and guide ids (tvg-id) that link channels to the TV guide.
  • The guide address in the header (url-tvg or x-tvg-url).
  • Catch-up settings (catchup, catchup-days, catchup-source, timeshift) for channels with an archive. See catch-up and live rewind.

MuskTV refreshes the playlist once a day, so new channels just appear. Favorites and hidden channels stay across refreshes.

When the playlist won't load

MuskTV tells you what went wrong instead of a generic error:

  • "Server not found": the address is mistyped, or the provider's server is down.
  • "Wrong username or password, or the subscription has ended": the provider refused the login inside the link (HTTP 401/403).
  • "Nothing found at this link": the path is wrong (HTTP 404). Check everything after the domain.
  • "Couldn't connect": the port is wrong or blocked. Addresses like http://host:8080/... need the port.
  • "The playlist has no channels": the link works but returned an empty list. Check your subscription with the provider.

M3U or M3U8?

Both are the same playlist format; M3U8 just means the file is UTF-8 text. MuskTV reads both. Channels inside can be HLS (.m3u8) or MPEG-TS streams; MuskTV detects which, even when the link doesn't say.

MuskTV doesn't provide playlists. Use the one from your own TV provider.

Keep reading