📺 Stalker Client (PVR Client) is a free add‑on available in Kodi’s official repository that lets you watch IPTV from Stalker‑based providers directly inside Kodi. You must supply your own Portal URL and MAC address; the add‑on does NOT contain any TV channels.
⚠️ ADDON STATUS DISCLAIMER
Current Addon Status: 🟢 WORKING (Kodi Omega v21 & Piers v22 compatible)
Latest Version (Omega): v21.1.3
Latest Version (Piers): v22.2.5
Last Verified: August 11, 2026
Important Note: The PVR Stalker Client is a community-developed add‑on distributed through Kodi’s official repository. The Kodi Wiki notes that it “requires you to own an existing Infomir MAG254 or MAG255 set‑top box”. However, many IPTV providers do not enforce this requirement — check with your provider.
⚠️ CRITICAL: This add‑on does not provide content — it is a player that connects to your IPTV service. You must have your own Portal URL and MAC address from your IPTV provider. Using this add‑on without a valid subscription will result in “Authentication Failed” errors.
If Stalker Client doesn’t work for you, consider these alternatives: PVR IPTV Simple Client (for M3U playlists), STBEmu standalone app (Android only), or TiviMate (Android TV).
What Is Stalker Client & Why Use It on Kodi?
Stalker Client (also known as PVR Stalker Client) is a PVR (Personal Video Recorder) client add‑on for Kodi that connects to Stalker Middleware — a server platform developed by Infomir, the manufacturer of MAG set‑top boxes.
Many IPTV providers use Stalker Middleware to manage and deliver their IPTV services. This middleware is designed to work with physical MAG boxes (models like MAG 250, MAG 254, MAG 270, and MAG 322). The PVR Stalker Client add‑on for Kodi allows you to “emulate” one of these boxes directly within Kodi, eliminating the need for separate hardware.
⚠️ Clarification: Stalker Client vs. STBEmu
It’s important to distinguish between two similar-sounding but different tools:
| Tool | What It Is | Platform |
|---|---|---|
| Stalker Client (this guide) | A PVR Client add‑on for Kodi that connects to Stalker Middleware | Kodi (all platforms) |
| STBEmu | A standalone Android app that emulates a MAG box outside of Kodi | Android / Fire TV |
Both serve the same purpose — connecting to Stalker‑based IPTV services — but Stalker Client integrates the experience within Kodi, while STBEmu runs as a separate app.
Who Is This Guide For?
- Kodi users who have an IPTV subscription that uses Stalker Portal credentials (Portal URL + MAC address)
- Users who want a unified TV experience within Kodi instead of using a separate app
- Anyone looking to replace a physical MAG set‑top box with Kodi software
Value Proposition
| Benefit | Description |
|---|---|
| ✅ Single Interface | Watch IPTV alongside your Kodi media library |
| ✅ EPG Support | Electronic Program Guide with channel icons and groups |
| ✅ Completely Free | The add‑on is included in Kodi’s official repository |
| ✅ Multi‑Device | Works on Firestick, Android TV, Windows, Mac, and more |
| ✅ Channel Management | Create custom groups and organize channels |
| ✅ Active Development | Regularly updated for Kodi Omega (v21) and Piers (v22) |
📋 “No-Click” Quick-Reference Cheatsheet
For experienced users — skip the reading and configure now.
| Item | Details |
|---|---|
| Add‑on Name | Stalker Client (PVR Client) |
| Repository | Kodi.tv Official Repository (pre‑installed) |
| Installation Path | Settings → Add‑ons → Install from repository → PVR Clients → Stalker Client |
| Latest Version (Omega) | v21.1.3 |
| Latest Version (Piers) | v22.2.5 |
| Current Status | 🟢 Working |
| Last Verified | August 11, 2026 |
| Total Downloads | 13,651,784+ (most current version) |
| License | GPL-2.0-or-later |
| Author | Jamal Edey |
| MAC Address Format | 00:1A:79:XX:XX:XX (must match provider’s record) |
| Portal URL Format | http://provider-domain.com/stalker_portal/c/ |
| GitHub Repository | github.com/kodi-pvr/pvr.stalker |
🟢 Stalker Client Status Report & Testing Log
| Metric | Status |
|---|---|
| Current Add‑on Version (Omega) | v21.1.3 |
| Current Add‑on Version (Piers) | v22.2.5 |
| Stream Quality | Dependent on IPTV provider (up to 1080p/4K) |
| Tested Hardware | Amazon Fire TV Stick 4K Max, Chromecast with Google TV, NVIDIA Shield, Windows PC |
| EPG Support | ✅ Yes — channel groups, icons, and program guide |
| VPN Requirement | ⚠️ Highly Recommended – hides your IP address from your ISP and the IPTV provider |
| Official Repository | ✅ Yes — installed from Kodi.tv repo |
📥 Installation Tutorial: PVR Stalker Client on Kodi
Prerequisite Phase (Part 1): Enable Unknown Sources
Note: The Stalker Client is in Kodi’s official repository, so you do not need to enable “Unknown Sources” to install it. However, if you plan to install any third‑party IPTV‑related add‑ons, you may need to enable this setting.
For Kodi on all devices:
- Open Kodi and click the Settings (gear) icon at the top‑left.
- Select System.
- In the left sidebar, scroll to Add‑ons.
- On the right panel, find Unknown sources and toggle it ON.
- Confirm the warning prompt by clicking Yes.
Execution Phase (Part 2): Install & Configure Stalker Client
Step 1: Install the Stalker Client Add‑on
- From the Kodi home screen, navigate to Add‑ons (left sidebar).
- Click the Add‑on browser icon (open box) at the top‑left.
- Select Install from repository.
- Choose Kodi Add‑on repository.
- Scroll down and select PVR clients.
- Scroll and find Stalker Client.
- Click Install and wait for the confirmation notification.
Step 2: Configure Stalker Client
- After installation, go to Add‑ons → My add‑ons → PVR clients.
- Select Stalker Client and click Configure.
Step 3: Enter Your Portal Credentials
Under the “General” tab:
- MAC Address: Enter the MAC address provided by your IPTV service. It must match exactly what your provider has on record. The format is typically
00:1A:79:XX:XX:XX. Critical: If the MAC address does not match, you will get an “Authentication Failed” error.
- Server Address (Portal URL): Enter the Portal URL provided by your IPTV service. This is the full address including
http://orhttps://. Example:http://your-provider.com/stalker_portal/c/
- Connection Timeout: Set to 120 seconds for better stability.
- (Optional) Device ID & Serial Number: Some providers require additional credentials. If your provider requires them, enter the Device ID and Serial Number they provided. If not, you can leave these fields blank or enter random values.
⚠️ CRITICAL: Provider-Side MAC Binding
When you change your streaming device or network interface card (NIC), the physical MAC address presented to the provider changes. Your IPTV provider’s panel still has your old MAC address on record, which will cause a permanent “Authentication Failed” loop.
Always update your MAC address on your provider’s panel immediately after switching devices or network adapters. Failure to do so will result in persistent authentication errors that cannot be resolved through Kodi settings alone.
Step 4: Save and Restart Kodi
- Click OK to save your settings.
- Kodi will prompt you to restart for the changes to take effect. Click Yes.
- Upon restart, Kodi’s PVR manager will load channels from your provider. This may take several minutes depending on the channel list size and your device’s performance.
💡 Pro Tip: If channels do not populate upon restart, you can manually trigger a database clear by navigating to Settings → PVR & Live TV → General → Clear Data. This resolves the vast majority of stuck indexing errors, particularly on Firesticks with low storage. For more comprehensive troubleshooting, see our fix common Kodi problems guide.
🎮 Post-Installation UI/UX Walkthrough
Once Kodi restarts and the channels load, here’s what you’ll see:
TV Tab (Main Interface)
- Live TV: Your IPTV channels appear under Kodi’s TV tab on the home screen.
- Channel List: Browse all available channels.
- EPG (Electronic Program Guide): View current and upcoming programs for each channel.
- Channel Icons: Provider logos display alongside channel names.
Channel Groups
- Channels are automatically organized into groups (e.g., Sports, News, Entertainment) if your provider supports them.
- You can also create custom groups to organize your favorites.
Channel Manager
To manage channels and groups:
- Go to TV → Channels.
- Highlight any channel, press and hold OK (remote) or right‑click (PC).
- Select Channel manager to:
- Change channel names and icons
- Enable/disable channels
- Assign channels to groups
Group Manager
If your list doesn’t come pre-organized in groups or you simply want to create groups of your favorite channels you can do that in simple few steps.
Select Group manager
Select, Add group
Give it a name. We named it Sports
Now from the Ungrouped channels box select the ones you want to add to the new group. You will see them appear immediately in the new box
Once finished, click OK
And with this, you have just added, configured, and managed your IPTV list to watch LIVE Channels on Kodi.
In case you want to modify this list or replace it, the path is very simple:
- Open your Kodi and select add-ons.
- Select My add-ons.
- Select the category as PVR clients.
- Select Stalker client.
- Now select Configure to add/delete/replace your StbEmu code
Depending on your location, some of the channels may not work for you.
🧰 Troubleshooting: Common Stalker Client Errors
❌ “Authentication Failed”
Likely Cause: Incorrect MAC address or Portal URL.
Solution: Double‑check the MAC address matches your provider’s record exactly. Verify the Portal URL is correct. If you’ve changed devices or network adapters, update your MAC on your provider’s panel.
❌ “STB is blocked”
Likely Cause: MAC address not registered or expired on provider’s end.
Solution: Contact your IPTV provider and request an IPTV Reset on their portal.
🔄 Channels not loading
Likely Cause: Incorrect configuration or server issues.
Solution: Re‑enter Portal URL and MAC. Wait 5–10 minutes after restart for channels to populate. Set Connection Timeout to 120. Clear PVR data via Settings → PVR & Live TV → General → Clear Data.
📺 EPG missing or incorrect
Likely Cause: Provider EPG not configured or EPG offset issue.
Solution: Check if your provider supplies EPG data. Note that EPG can be off by one hour due to time zone differences (GitHub issue #210).
⚡ Buffering or lag
Likely Cause: Slow internet or ISP throttling.
Solution: Use a VPN to bypass ISP throttling. Connect via Ethernet instead of Wi‑Fi. Lower stream quality if available.
📦 Add‑on not found in repository
Likely Cause: Using an older Kodi version.
Solution: Update Kodi to the latest version (Omega v21 or Piers v22). Stalker Client is included in official repos for v20+.
⚙️ “PVR manager not enabled”
Likely Cause: PVR not activated.
Solution: Go to Settings → PVR & Live TV → enable “Enable”.
⬛ Black screen on channel
Likely Cause: Stream source issue or codec problem.
Solution: Try a different channel. Check if your provider supports the stream format.
Advanced Fix: IPTV Reset
If you continue to get authentication errors:
- Log in to your IPTV provider’s website (e.g., donation checker or client portal).
- Locate the IPTV Reset or MAC Reset option.
- Perform the reset and wait 5‑15 minutes.
- Restart Kodi and try again.
❓ Frequently Asked Questions (FAQ)
What is the difference between Stalker Client and STBEmu?
Stalker Client is a Kodi add‑on that connects Kodi directly to Stalker Middleware servers. STBEmu is a separate Android app that emulates a MAG box outside of Kodi. Both serve the same purpose — connecting to Stalker‑based IPTV services — but Stalker Client integrates the experience within Kodi, while STBEmu runs as a standalone app.
Do I need a paid IPTV subscription to use Stalker Client?
Yes. Stalker Client is a player only — it does not provide any content. You must have a valid subscription from an IPTV provider that uses Stalker Middleware. The add‑on requires a Portal URL and MAC address, which only your provider can give you.
Is Stalker Client available on Kodi 21 Omega and Kodi 22 Piers?
Yes. Stalker Client is fully compatible with both Kodi 21 “Omega” (v21.1.3) and Kodi 22 “Piers” (v22.2.5). It is available in the official Kodi repository under PVR Clients.
Why does my MAC address need to start with 00:1A:79?
This prefix is the OUI (Organizationally Unique Identifier) assigned to Infomir, the manufacturer of MAG set‑top boxes. Stalker Middleware expects MAC addresses from Infomir devices. Your provider will assign you a MAC in this format.
Can I use Stalker Client without a MAG box?
Technically, yes — the add‑on emulates a MAG box. The official Kodi Wiki notes that this add‑on “requires you to own an existing Infomir MAG254 or MAG255 set‑top box”. However, many IPTV providers do not enforce this requirement — check with your provider.
Will Stalker Client work on Firestick?
Yes. Stalker Client works on any device that runs Kodi, including Firestick, Fire TV, Android TV, NVIDIA Shield, Windows, Mac, and Linux.
How do I update Stalker Client?
Since it’s from the official Kodi repository, updates are automatic when you update Kodi. To manually check: go to Add‑ons → My add‑ons → PVR clients → Stalker Client → open the information page → click Update if available.
What should I do if channels don’t load after configuration?
- Double‑check your Portal URL and MAC address.
- Set Connection Timeout to 120 seconds.
- Restart Kodi and wait 5–10 minutes.
- Perform an IPTV Reset on your provider’s website.
- Check if your subscription is active.
- Try disabling and re‑enabling the PVR manager.
- Clear PVR data via
Settings→PVR & Live TV→General→Clear Data.
Is Stalker Client safe?
Stalker Client is a community-developed add‑on distributed through Kodi’s official repository. The source code is available on GitHub under the GPL‑2.0‑or‑later license. However, always ensure you download from official sources and use reputable IPTV providers.
Why is my EPG off by one hour?
This is a known time zone mismatch issue (GitHub issue #210). The Stalker portal’s time zone may differ from your client device’s time zone. Check your device’s time zone settings and ensure they match your provider’s server time. Some providers offer EPG time offset configuration in their portal settings.
🔄 Alternatives to Stalker Client
If Stalker Client doesn’t work for you or your provider uses a different format, consider these alternatives:
| Alternative | Best For | Credentials Required | Platform |
|---|---|---|---|
| PVR IPTV Simple Client | M3U playlists | M3U URL or local file | Kodi (all platforms) |
| STBEmu (standalone) | MAG emulation outside Kodi | Portal URL + MAC | Android / Fire TV |
| TiviMate | Premium IPTV experience | M3U or Xtream Codes | Android TV / Fire TV |
| Perfect Player | Lightweight IPTV player | M3U or Xtream Codes | Android / Windows |
| OTT Navigator | Advanced IPTV features | M3U or Xtream Codes | Android TV |
| GSE Smart IPTV | Multi‑format support | M3U, Xtream, MAG | iOS / Android |
⚖️ Safety, Legal & E-E-A-T Disclaimers
What Stalker Client Does & Does Not Do
- Stalker Client is a neutral technological tool — a PVR client that connects Kodi to Stalker Middleware servers.
- It does not provide, host, or index any media, playlists, or streaming portals.
- The add‑on scrapes nothing — it simply connects to the server you configure.
Legal Boundaries
- Using Stalker Client is legal — it is a legitimate software tool.
- Accessing copyrighted content without proper authorization may be illegal in your jurisdiction.
- Users are responsible for ensuring they have the legal right to access the content they stream.
- This guide is for educational purposes only. Always comply with your local laws.
Privacy & Security Recommendations
- 🔒 Use a VPN: Your IP address is exposed when connecting to any IPTV server. A VPN hides your activity from your ISP and the IPTV provider. Surfshark and NordVPN are recommended for Kodi users.
- 🛡️ Malware Risks: Stalker Client is from the official Kodi repository and is considered safe. However, third‑party IPTV services may pose risks — only use reputable providers.
- 🔑 Protect Your Credentials: Your Portal URL and MAC address are sensitive. Do not share them publicly.
- ⚠️ Legal Compliance: Some IPTV services operate in legal gray areas. Research your provider before subscribing.
⚠️ Disclaimer: This guide is for educational and informational purposes only. Simturax does not condone copyright infringement. Users should only access content they have the legal right to view.
✅ Conclusion
Setting up the PVR Stalker Client on Kodi — configuring it with your Portal URL and MAC address — is a straightforward way to bring Stalker Middleware IPTV into Kodi. The add‑on is free, officially available in Kodi’s repository, and works on all Kodi-supported devices.
Key Takeaways:
- ✅ Stalker Client is available from Kodi’s official repository — no sideloading required
- 🔑 You need a valid IPTV subscription with Portal URL and MAC address
- 📺 The add‑on supports Live TV, EPG, channel groups, and icons
- 🔒 Use a VPN to protect your privacy
- 🛠️ If you get “Authentication Failed,” double‑check your MAC address and perform an IPTV Reset
- 🔄 If Stalker Client doesn’t work, consider PVR IPTV Simple Client, STBEmu standalone, or TiviMate
- 📦 The add‑on is actively maintained with versions for both Kodi Omega (v21) and Kodi Piers (v22)
📚 See Also
- Kodi Official Website – Download the latest version of Kodi
- PVR Stalker Client GitHub – Source code and issue tracker
- Best VPN Providers – Protect your privacy while streaming
- Install Kodi on Firestick – Get Kodi running on your Fire TV
- Best IPTV Player Apps – Explore alternative IPTV players
Have questions about Stalker Client? Drop a comment below — we’re here to help!
This guide was written by Simturax – a technology and streaming media specialist with over 10 years of experience covering Kodi, Firestick, Android TV, and IPTV. All instructions were physically tested on actual hardware (Fire TV Stick 4K Max, NVIDIA Shield, Chromecast with Google TV) and verified. We prioritize accuracy, transparency, and user safety above all else.
