MAG Set-Top Boxes

A MAG box does not use a playlist. It boots, announces its MAC address, and expects a portal to answer. XUI.live speaks that protocol natively: register the MAC, and the box receives the Ministra-style portal — channels, VOD and guide — with no configuration on the device beyond the portal URL.

Open MAG Devices → Add Device.

The device

MAC address is the identity — the box is recognised by it, so there is nothing to type on the TV. A paired line carries the subscription underneath: owner, expiry or never-expire, trial flag, bouquets — the same anatomy as any line, bound to hardware.

Device info stores what the box reports — serial number, STB model, firmware image and hardware version — so support conversations start with facts.

Two device-side protections:

• Lock device — pins the account to this box; the credentials are useless anywhere else.
• Adult PIN — locks adult-flagged categories behind a code on the portal.

The Restrictions set from lines applies here too: allowed IPs, ISP lock with one-click clear, forced country, forced server.

Talking to the screen

Select a device — or a whole fleet — and Send Event:

• Message — text on the TV screen, with an optional confirmation the viewer must acknowledge.
• Play channel — switch the box to a chosen channel.
• Reboot — restart the portal, immediately or after the viewer confirms.

Payment reminders, maintenance notices, a nudge to the channel where the match is about to start — delivered to the living room, not to an inbox nobody reads. Queued events sit in MAG Events until each box picks them up, and everything sent is recorded in the MAG event logs.

The fleet

The devices list filters by owner, status and expiry, with per-row and bulk ban, disable, kill connections — and convert to line, which turns a MAG subscription into an ordinary playlist line when a customer swaps their box for an app. Nothing is re-sold; the same subscription changes shape.

Programmatically it is the same surface as everything else: create_mag, edit_mag, convert_mag and mag_events on the Admin API, and the reseller-scoped equivalents on the Reseller API.

The other set-top-box family — Enigma2 receivers — works on the same pairing idea with its own device screen, and packages decide what either kind of device may be created with. Both are next in this section.