Skip to main content

How-to guides

Short, task-focused recipes for the everyday jobs you'll do in the console.

Each recipe below stands on its own — jump to the one you need. You'll find the main areas (Devices, Sources, Lineup, Usage) in the left sidebar of the console.

Add or remove a device​

Register a player so it can pull a channel lineup, or retire one you no longer manage.

To add a device:

  1. Open Devices from the sidebar.
  2. Click + Device in the top-right.
  3. Enter the device's MAC address (the identifier printed on the device or shown in its network settings).
  4. Optionally give it a friendly Name (for example, "Lobby TV") and pick a Group.
  5. If you'd like to finish setup in one step, click + Add streaming credentials now and fill in the username and password. You can always add these later.
  6. Click Register.

To remove a device:

  1. On the Devices page, find the device in the list.
  2. Open its row actions and choose Remove.
  3. Confirm in the dialog. Removing a device is permanent and also deletes its stored credentials, so double-check the name before you confirm.

Add credentials to a device​

A device loads its channel list right away, but it can't play any stream until you add its playback credentials. Any device still waiting shows a Needs creds badge and a reminder banner at the top of the Devices page.

  1. Open Devices.
  2. Click a device's Needs creds badge (or select the device and open the Credentials tab in the side panel).
  3. Enter the Username and Password for that device.
  4. Optionally add an XMLTV URL (for the programming guide) and any Notes to help you remember the provider or customer reference.
  5. Click Save.

Once saved, the device shows Configured with the date it was last updated. To view the stored password later, use Reveal — it copies to your clipboard and auto-hides after 30 seconds. To stop a device from playing, use Clear to remove its credentials.

Organize devices into groups​

Groups keep large fleets tidy and let you assign one lineup to many devices at once.

Create a group:

  1. On Devices, click + Group.
  2. Give it a name (for example, "Lobby" or "Floor 2") and click Create.

Move a device into a group:

  1. Open a device's row actions and choose Move.
  2. Pick the group (or Ungrouped) and click Move.

Assign a lineup to a whole group:

  1. Click Manage groups.
  2. Next to the group, click the assign icon.
  3. Choose a lineup and confirm. This writes that lineup to every device in the group, replacing any per-device choice.

In the device list, groups can be collapsed or expanded by clicking the group header, so you can focus on one area at a time. To delete a group, open Manage groups and click the remove icon — you'll need to move its devices elsewhere first.

Edit and re-publish a lineup​

Your working lineup is where you arrange channels. Devices only see your changes after you publish.

  1. Open Lineup from the sidebar.
  2. Use the lineup name dropdown at the top to pick the lineup you want to edit (or click + New to start a fresh one).
  3. In the left pane (your channel source), find channels and click to add them to the working lineup on the right.
  4. In the right pane, fine-tune the lineup: renumber channels, rename them, reorder them, or remove ones you don't want.
  5. Your edits save automatically. The Saved ✓ pill near the lineup name shows the current state — you can click Save now to save immediately.
  6. When you're happy, click Publish.
  7. In the publish dialog, review how many assigned devices are online. Choose Publish & Push to update online devices right away, or Publish, no push to snapshot the new version and let devices pick it up the next time they start.

Offline devices always receive the latest published version the next time they come online, whichever option you choose.

Bulk-import device credentials from a CSV​

When you're setting up many devices at once, import their credentials in a single batch instead of typing each one.

  1. On Devices, click Bulk import credentials.
  2. Click Download template to get a correctly formatted starting file. The columns are: mac, username, password, xmltvUrl, notes (the last two are optional).
  3. Add your rows, then either Paste CSV into the box or switch to Upload CSV and choose your file.
  4. Review the preview. Each row is checked and marked — valid rows show a checkmark, and any invalid row is flagged with the reason (for example, a device that isn't registered, a duplicate, or a missing username). A summary at the top shows how many will import and how many can't.
  5. Click Apply to import the valid rows. Invalid rows are simply skipped, so one bad row never blocks the rest.
  6. If any row fails during import, it stays visible with its reason. Fix it and click Apply again — only the outstanding rows are retried, and rows that already succeeded are never re-sent.

Read your usage analytics​

The Usage page shows what your customers are actually watching.

  1. Open Usage from the sidebar.
  2. Choose a tab:
    • Top channels — your most-watched channels by total watch time. Use the dropdown to switch between the last 7, 30, or 90 days.
    • Heatmap — viewing by hour of day, so you can spot peak times. Adjust the range with the dropdown.
    • Per-device — session history for a single device. Pick a device to see when it was on, which channel it played, and for how long.

If a chart can't load, you'll see a short message with a Retry button rather than an empty graph.

Change your channel source​

Your channel source is where the platform imports your channel catalog from. Change it when you switch providers or update your access details.

  1. Open Sources from the sidebar.
  2. In the Catalog source panel, click Edit (or fill in the form if no source is set yet).
  3. Choose your source type and enter the details your provider gave you, including the username and password.
  4. Click Test connection to confirm the details work.
  5. Click Save and Discover. The console fetches your catalog and shows a review of what changed — how many channels and categories it found compared to what you have now.
  6. Review the counts, then click Import to confirm. This replaces your current catalog and takes a few seconds.

After importing, head to the Lineup page to build lineups from your refreshed catalog, then publish them so your devices pick up the changes.