Skip to content

Adding a Screen

Adding a Screen

A Screen is a single physical display — a TV, monitor, or kiosk — running Stratos player software. The Screens page is where you authorize new screens, watch their health, and send them commands.

How to get there: Sidebar → Screens, or /screens.

The page is split in two:

  • Left: a folder tree. Click a folder to filter the list; the table only shows screens in that folder. Right-click the folder for actions like Manage Permissions, Create Folder, Delete Folder.
  • Right: the screens themselves, plus a header showing live counts: Total, Online (green), Offline (red).

On narrow screens (under 1024px wide), the table swaps to a mobile card list — one card per screen.

The first time a player connects, it shows up in Stratos as unauthorized — it can’t display content yet. When you have unauthorized screens, a yellow callout appears at the top of the page listing them with an Authorize button on each row.

Click Authorize and the screen becomes active immediately. You’ll usually want to give it a sensible name and a default layout right after — see Editing a screen below.

ColumnWhat it shows
NameScreen name. Clickable — opens the screen detail page at /screens/[id].
GroupThe screen group this screen is part of (if any).
ResolutionWidth × height of the screen.
RotationDisplay rotation (0°, 90°, 180°, 270°).
StatusOnline (green) or Offline (red), based on whether the player has checked in within its expected interval.

A screen registers itself the first time the player software contacts Stratos. From your side, the workflow is:

  1. Install the Stratos player on the device and configure it to point at your Stratos URL.
  2. Refresh the Screens page. The new screen appears in the Pending Authorization callout.
  3. Click Authorize.
  4. (Optional but recommended) Edit the new screen to set a clear name and a default layout.

The Add Screen button in the page header opens a create dialog to manually register a screen by name, resolution, and optional screen group. You need write permission on screens to see this button.

Click any screen row (or its name) to open the detail page at /screens/[id]. Here you’ll find:

  • Current online status and last check-in time.
  • Hardware information — resolution, rotation, player software version.
  • Content — current default layout, screen group membership, and assigned schedules.
  • Device — device action buttons (see below).

Right-click a row → Edit, or open the screen detail page and use the edit controls. The screen edit dialog lets you change:

  • Name
  • Default layout — the fallback content shown when no schedule is active. A “Be Right Back” slate or branded idle screen works well.
  • Screen Group — add the screen to a group for bulk scheduling.
  • Resolution — width and height in pixels.
  • Rotation — display orientation.

Click Save. The player picks up changes on its next check-in.

From the screen detail page, the Device section has action buttons:

ActionWhat it does
Take ScreenshotAsks the player for a screenshot of what’s currently on screen.
Refresh ContentTells the player to contact Stratos immediately and pull any pending content or schedule changes.
RebootPower-cycles the entire device. Use when the player is unresponsive.

Commands are queued and picked up on the player’s next manifest poll.

Right-click a row → Move to Folder. Pick a destination from the dropdown (use Root for no folder) and click Move. The change applies immediately.

Folders are managed from the left sidebar, not from individual rows. Right-click any folder to:

  • Manage Permissions — open the folder access dialog and set who can see this folder’s contents.
  • Create Folder — create a sub-folder.
  • Delete Folder — remove the folder. (Screens in the folder become unfiled.)

Folder access drives screen visibility — see Folders for the full model.

If a physical player should stop receiving content, remove it from schedules and groups or contact support for help removing it from your account.

  • The Screens sidebar item appears only when your role includes screen access.
  • The Add Screen button requires write permission on screens.
  • The Authorize action requires write permission on the specific screen (or its folder).
  • Action buttons in the Device section require the appropriate screen permission.
  • Screen Groups — group screens for shared scheduling.
  • Sync Groups — keep multiple screens playing in lock-step.
  • Display Profiles — reusable player configuration templates.
  • Folders — folder structure and permissions.
  • Commands — define custom commands you can send to a screen.