IPTV RwandaKIGALI · RW · 4K
Setup GuideRead time: 12 minUpdated By The IPTV Rwanda Tech Desk

Xtream Codes Setup Guide for IPTV Rwanda: Every Device, Step by Step

Setting up IPTV Rwanda takes about ten minutes once you know which login type your app wants. This guide covers Xtream Codes and M3U on Fire TV, TiviMate, IPTV Smarters Pro, Samsung and LG smart TVs, Apple TV, MAG and Formuler, plus the Kigali-specific details: the UTC+2 programme guide offset, 50 Hz frame-rate matching and running the box from an inverter circuit.

What you need before you start

After payment by Visa or Mastercard (3-D Secure), your credentials arrive by email within minutes. You will receive three things for the Xtream Codes method: a server URL, a username and a password. For the M3U method you also get a playlist link and an EPG (XMLTV) link. Keep that email open on your phone, because typing long URLs with a TV remote is the most common cause of failed setups.

You also need a stable connection. For one 1080p stream, plan on 6-8 Mbps in H.264 (4-5 Mbps in HEVC); 4K HEVC needs 15-25 Mbps, 720p 3-4 Mbps and SD 1.5-2.5 Mbps. If you are not sure what your line delivers, run the speed test first, and read the buffering guide if the numbers look thin. Our service carries 120,000+ live channels and 150,000+ VOD movies and series, so give the app a minute to load the first time.

Tip: copy the server URL exactly, including http:// and the port number. A missing colon or a trailing space is behind most "invalid login" messages.

Xtream Codes vs M3U: which one to use

Xtream Codes is a login method: server, username, password. The app asks the server for the channel list, categories, VOD library and guide data itself. M3U is a flat playlist file, and the guide is a separate XMLTV link you add by hand. Both work, but they behave differently.

FeatureXtream Codes loginM3U playlist + EPG
Typing neededThree short fieldsOne long link, plus an EPG link
Guide (EPG)Loaded automaticallyAdd the XMLTV URL manually
VOD movies and seriesOrganised with postersOften one huge list
Catch-up and categoriesSupported in most appsApp-dependent
Best forTiviMate, Smarters, FormulerVLC, some MAG and TV apps

Our advice is simple: use Xtream Codes wherever the app offers it, and fall back to M3U only for VLC and for older boxes that lack an Xtream option. The M3U route also loads slowly on cheap hardware, since the whole list is downloaded as a single file of several megabytes.

Fire TV and TiviMate

A Fire TV Stick 4K is the most common box in Kigali homes, from apartments in Kacyiru to compound houses in Kicukiro. TiviMate on it is our favourite combination.

  1. On the Fire TV, open Settings, My Fire TV, Developer Options and switch on "Install unknown apps" for the downloader you use. Install TiviMate from the app store or the downloader.
  2. Launch TiviMate and choose Add playlist, then Xtream Codes.
  3. Enter the server URL, username and password exactly as emailed. Name the playlist anything you like.
  4. TiviMate downloads the channels and guide. Wait until the progress bar finishes; on first load that can take a minute or two.
  5. Open Settings, then Playback, and set the network buffer to Medium (about 15-30 seconds on busy Wi-Fi or 4G).

In TiviMate, leave the user-agent at its default and keep hardware decoding on. If a 4K channel stutters on a 1 GB-RAM stick, lower the stream to 1080p before changing anything else. A Fire TV Stick 4K with a USB-Ethernet adapter is worth the small cost if the TV sits far from the router.

IPTV Smarters Pro, Android TV and Google TV

IPTV Smarters Pro is the easiest app for newcomers and works on Android TV, Google TV, Nvidia Shield, TCL and Hisense televisions, phones and tablets.

  1. Install IPTV Smarters Pro from the store on the device.
  2. Choose Login with Xtream Codes API.
  3. Enter any name in the first field, then username, password and the server URL.
  4. Tap Add user. The app loads Live TV, Movies and Series.
  5. Open Settings and switch the player to the hardware decoder. If a specific channel shows picture problems, test the alternative player once.

On budget TCL and Hisense sets with 1 GB of RAM, keep the app's refresh options modest. Large libraries can slow the first launch, and a restart of the TV after the first load often clears a sluggish menu. Where the TV has a weak Wi-Fi chip, use its Ethernet port.

Samsung (Tizen) and LG (webOS)

Smart TVs install apps from their own stores, and the choice of IPTV players varies by model year. In general, search the Samsung or LG app store for a player that supports Xtream Codes or M3U, and use the same three credentials as above. Most of these apps ask for a playlist name, the URL, and sometimes a username and password if they are Xtream-aware.

  • Samsung (Tizen): open Apps, search for an IPTV player, install, then add the playlist using the server details or the M3U link. Sets from roughly 2018 onwards are the most reliable. Older ones may not support HEVC well, so choose a 1080p H.264 category.
  • LG (webOS): open the LG Content Store, search for a player, and add the Xtream credentials. LG sets from about 2019 onwards decode HEVC in hardware.
  • Remote typing: both brands accept a phone as a keyboard through their companion apps, which saves a lot of frustration on long URLs.

If the TV app is slow or lacks the guide, the better path is a Fire TV Stick or Android TV box plugged into an HDMI port. A TV's own processor is usually weaker than a dedicated box, and the stick receives app updates for longer. See the buying guide for device picks.

Apple TV, MAG and Formuler

Apple TV

Apple TV works well with IPTV Smarters Pro or another Xtream-aware player from the tvOS store. Install, choose the Xtream Codes option and enter the details. Apple TV 4K handles HEVC and Dolby 5.1 audio cleanly. Turn on frame-rate and dynamic range matching in Settings, Video and Audio, Match Content (see the 50 Hz section below).

MAG boxes

MAG boxes use a portal rather than an Xtream login. In the box menu go to Settings, Servers, Portals and enter the portal name and URL given by support, then restart. Note the MAC address on the sticker underneath the box, since the portal ties to it. Contact the Tech Desk on WhatsApp for MAG activation, as it needs a manual step from our side.

Formuler

Formuler boxes run MYTVOnline. Open the app, add a new portal, pick the Xtream Codes type and enter name, server URL, username and password. Formuler supports an EPG per portal and a remote with dedicated guide keys, which makes it a favourite for households that switch channels all day. Increase the buffer in the app's Settings if the home link is 4G.

EPG time zone: the UTC+2 offset

When the guide shows programmes an hour or two off, the cause is almost always the time zone. Rwanda uses Central Africa Time (CAT, UTC+2, Africa/Kigali) all year, with no daylight saving. The guide data is supplied in a standard time, and your app needs a matching offset.

  1. First check the time zone on the device itself. Set it to Kigali, CAT, UTC+2. On Fire TV that is Settings, Preferences, Time Zone. On Android TV it is Date and time, with automatic time zone off if the box guesses wrong.
  2. In TiviMate, open Settings, then EPG, then Time offset, and adjust in whole hours until a news bulletin starts at the listed time.
  3. In Smarters Pro, use the EPG time shift in the settings; try +0 first, then +2 if the guide is still wrong.
  4. Refresh the guide once after any change and give it a minute to reload.

Because Rwanda does not change clocks, set the offset once and leave it. The UK does change, so the gap to UK programming moves: a 3 pm UK kick-off is 5 pm in Kigali in UK winter and 4 pm in UK summer. A 8 pm US Eastern game falls at about 2 or 3 am. If a guide looks wrong only in spring and autumn, that is the UK or US clocks shifting, not your set-up.

Warning: do not stack corrections. If you set the device time zone wrong and also apply an EPG offset, the two cancel or double. Fix the device first, then adjust the offset.

50 Hz frame-rate matching

Rwanda's mains supply is 230 V and 50 Hz, and most European and many African channels broadcast at 25 or 50 frames per second. Film and US content is usually 24 or 30. When the box outputs a fixed 60 Hz, 25 and 50 fps channels judder, which you notice as a stutter in slow camera pans and football. It looks like buffering but it is not.

  • Apple TV: Settings, Video and Audio, Match Content, switch on Match Frame Rate and Match Dynamic Range.
  • Fire TV: Settings, Display and Sounds, Display, Match Original Frame Rate set to Always or the automatic option.
  • Nvidia Shield and Android TV: in Display settings enable "Match content frame rate" or the equivalent.
  • TiviMate and Smarters: some versions expose an auto frame-rate switching option in the player settings; enable it.
  • Samsung and LG: keep the picture mode at Movie or Filmmaker, and switch off heavy motion smoothing if it creates a soap-opera look.

The TV must support 50 Hz output. Nearly every set sold for this market does. If the screen blinks for a second when you change channel, that is the matching working and is normal.

Setting up on an inverter or backup circuit

Power cuts and scheduled outages are common enough, especially outside Kigali, that a lot of households put their TV on an inverter circuit. Done well, your viewing carries through an outage. Done badly, you get reboots and corrupt app data.

  • Put the ONT, router and box on the same protected circuit. A TV on the inverter with the router on the raw grid gives you a picture and no internet.
  • Use a pure sine wave inverter for the TV and box. Cheap modified-sine units can make switching supplies hum or run hot.
  • Size it properly. ONT and router draw 15-25 W, a streaming box 5-10 W, a 43-inch TV 60-120 W. Around 150 W total on a 1 kVA inverter with a healthy battery gives many hours of runtime, hedged for battery age.
  • Stagger the restart. After a long cut, power the ONT first, wait for its light to go solid, then the router, then the box.
  • Use a small DC mini-UPS on the ONT and router if there is no inverter; a 52 Wh unit gives roughly 2 to 3 hours.
  • Protect against surges during the rains with a fused surge strip on Type C or Type J sockets.

Full runtime numbers and the reboot sequence are in the buffering guide. If you are weighing fibre against 4G home routers for the backup link, the ISP comparison covers MTN Rwanda (Fibre to the Home), Airtel Rwanda and CanalBox Rwanda (GVA Fibre).

Troubleshooting login and playback

If the app rejects your details, work through this list in order.

  1. Re-read the email and retype the username and password. They are case-sensitive, and the letter l, number 1 and capital I are easily confused.
  2. Check the server URL has no trailing space and includes http:// and the port.
  3. Confirm the box has working internet by opening another app.
  4. Set DNS on the router to 1.1.1.1 and 8.8.8.8, then restart the box.
  5. Check the date and time on the device. A wrong clock breaks secure connections.
  6. Remove the playlist and add it again rather than editing it. Stale cached data is a frequent culprit.

Playback failing on one channel only is a source matter, and support can switch you to another server. Typical round-trip time from Kigali to our Nairobi edge is 20-35 ms on fibre and 40-80 ms on 4G, with Johannesburg as a secondary at about 45-65 ms, so a very high ping to the server usually points to your own line.

Each subscription can be used on several devices, but check the connection limit in your welcome email before running more screens than your plan permits. Plans are $11 for one month, $19 for three months, $29 for six months and $39 for twelve months, which is the best value at about $3.25 a month and saves $93 compared with paying monthly. See pricing. Payment is by Visa or Mastercard only, there is a 30-day money-back guarantee, and there is no free trial.

Users are responsible for using the service in line with local law.

Frequently asked questions

What is the difference between Xtream Codes and M3U?

Xtream Codes is a three-field login (server, username, password) from which the app loads channels, VOD and the guide. M3U is a playlist link, and the XMLTV guide link is added separately. Use Xtream Codes wherever the app offers it.

Which app is best for IPTV in Rwanda?

TiviMate on a Fire TV Stick 4K is our first pick for daily viewing, and IPTV Smarters Pro is the easiest for beginners. VLC works for M3U on computers and phones. Formuler and MAG boxes suit households that want a dedicated set-top box.

Why is my programme guide one or two hours off?

Rwanda uses Central Africa Time, UTC+2, all year with no daylight saving. Set the device time zone to Kigali first, then adjust the app's EPG time offset in whole hours until the schedule matches.

Why does football look jerky even though it does not buffer?

That is usually a frame-rate mismatch. Many channels run at 25 or 50 fps while the box outputs 60 Hz. Turn on frame-rate matching in the box or app settings and confirm the TV supports 50 Hz.

Can I run the box on an inverter during a power cut?

Yes, as long as the ONT, router and box are all on the protected circuit. A pure sine wave inverter is best. After a long outage, restart the ONT first, then the router, then the box.

How do I set up a MAG box?

Enter the portal URL from support under Settings, Servers, Portals, then restart. The portal is tied to the MAC address on the box sticker, so message the Tech Desk on WhatsApp with that address.

How fast do I receive my login details?

Credentials are emailed within minutes of a successful card payment. If nothing arrives, check your spam folder and then message support on WhatsApp or email, available 24/7.

Why is there no free trial?

Because every plan already carries a 30-day money-back guarantee on Visa and Mastercard payments, so you can set up, test on your own line, and ask for a refund if it does not suit you.

Stream in 4K across Rwanda

From $11 · Visa / Mastercard · 30-day money-back guarantee

Written and tested by The IPTV Rwanda Tech Desk — network engineers and support staff based in Kigali, serving customers from Rubavu to Nyagatare and from Musanze to Rusizi.
Chat with us on WhatsAppRwanda support · replies in minutes