Skip to main content

Getting started: your first lineup

Go from a brand-new account to a device playing your channels in six short steps — about ten minutes, start to finish.

Everything you do lives in your console. The left sidebar has the pages you'll use here: Dashboard, Devices, Usage, Sources, Lineup, and Account. We'll visit Sources, Devices, and Lineup in order.

Before you start​

Have these two things handy:

  • Your channel source details — the URL and sign-in credentials from your channel provider.
  • Your device — powered on and connected to the internet, with its MAC address available (it's usually on a sticker on the device, or in its on-screen network settings).

Step 1 — Create your account and sign in​

  1. Open the console and choose Start a free trial.
  2. Enter your email and a password (8+ characters). No card is required for the trial.
  3. Tick the box to accept the Terms, Privacy Policy, and Acceptable Use Policy, then select Start free trial.
  4. You'll land on your Dashboard, signed in and ready to go.

Already have an account? Choose Sign in instead and enter your email and password. Forgot your password? Use Forgot your password? to get a reset link by email.

Step 2 — Connect your channel source​

Your channel source is where the platform imports your channel catalog from. You configure it once, on the Sources page.

  1. In the sidebar, open Sources.
  2. Under Catalog source, pick how your provider delivers your catalog:
    • Xtream Codes API — you'll enter an API base URL plus a username and password.
    • M3U URL — you'll paste a playlist URL. The console tries to detect the username and password from the URL automatically; if it can't, you'll enter them by hand.
  3. Fill in the fields for the option you chose.
  4. Select Test connection. A success message confirms the console can reach your provider — and often shows how many channels it found. If the test fails, double-check the URL and credentials and try again.
  5. When the test looks good, select Save and Discover. The console saves your credentials, then scans your provider's catalog.

Reviewing your catalog​

After discovery, you'll see a short Review import panel with the number of channels and categories found. Select Import to bring that catalog into your library. This takes a few seconds. Once it finishes, your channels are ready to build lineups from.

Tip: Your saved username and password are always hidden. You can select Show to reveal them briefly if you need to check them, and they re-hide on their own.

Step 3 — Register a device​

Now tell the console about the device that will play your channels. This happens on the Devices page.

  1. In the sidebar, open Devices.
  2. Select Register a device (or + Device).
  3. Enter the device's MAC address in the format AA:BB:CC:DD:EE:FF.
  4. Optionally give it a friendly Name (like "Lobby TV") and assign it to a Group.
  5. Select Add streaming credentials now and enter the Username and Password the device will use to stream. You can also add an optional guide (XMLTV) URL and a note for your own reference.
  6. Select Register.

Why credentials matter: without streaming credentials, a device can load its channel list but can't actually play anything. If you skip this step, the device shows a Needs creds badge on the Devices page — select it any time to open the device's Credentials tab and finish setup.

Step 4 — Build a lineup​

A lineup is the ordered set of channels a device shows. You build it in the Lineup editor.

  1. In the sidebar, open Lineup.
  2. Select + New to create your first lineup and give it a name.
  3. You'll see two side-by-side panels:
    • The left panel is your channel source — every channel from the catalog you imported, searchable and grouped by category.
    • The right panel is your working lineup — the channels this lineup will actually carry.
  4. Find channels on the left and add them to your lineup. Channels you've already added appear grayed out so you won't add them twice.
  5. On the right, you can renumber channels, rename them, and leave numbered gaps where you'd like spacing.

Your work saves automatically a few seconds after each change — watch the Saved ✓ indicator near the lineup name. You can select Save now to save immediately, or use Undo to roll back your last save.

First time here? If you haven't imported a catalog yet, the editor shows a banner linking you back to Sources to configure or import — or an Import catalog now shortcut if your source is already connected.

Step 5 — Assign the lineup to your device​

A lineup only reaches a device once it's assigned to it.

  1. Return to the Devices page.
  2. Find your device in the list and choose the lineup you built from its lineup picker.
  3. You'll see a brief confirmation that the assignment saved.

Prefer to manage devices together? Create a Group, assign the lineup to the whole group at once, and every device in it inherits the lineup.

Step 6 — Publish​

Publishing takes the lineup you've been editing and makes it the live version your devices receive.

  1. Back on the Lineup page, with your lineup selected, choose Publish.
  2. A summary appears showing how many assigned devices you have, and how many are online right now.
  3. Choose how to deliver it:
    • Publish & Push — publishes and immediately signals online devices to reload, so they pick up the new lineup right away.
    • Publish, no push — publishes the new version without nudging devices; they'll pick it up on their own the next time they start up.

What the publish progress means​

Publishing runs through a few quick stages, shown as it works:

  • Snapshotting working state — capturing exactly what's in your lineup right now.
  • Fetching EPG — pulling in the programming guide, if you've configured one.
  • Writing bundle — packaging the lineup for delivery.
  • Pushing to devices — signaling online devices to reload (only when you chose to push).

When it finishes, you'll see a confirmation — including how many devices are reloading. If any assigned device is still missing streaming credentials, the console warns you here so you can fix it on the Devices page.

What happens next​

That's it — your first lineup is live.

  • Devices that are online and set to push start reloading within moments and will be playing your channels shortly.
  • Devices that are offline pick up the new lineup automatically the next time they start up.

In general, a device picks up a freshly published lineup within about a minute. From here, you can keep editing your lineup and republish any time, register more devices, or organize devices into groups — your published lineup stays live until you publish a new version.