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.
Page layout
Section titled “Page layout”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.
Pending authorization
Section titled “Pending authorization”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.
Columns in the table
Section titled “Columns in the table”| Column | What it shows |
|---|---|
| Name | Screen name. Clickable — opens the screen detail page at /screens/[id]. |
| Group | The screen group this screen is part of (if any). |
| Resolution | Width × height of the screen. |
| Rotation | Display rotation (0°, 90°, 180°, 270°). |
| Status | Online (green) or Offline (red), based on whether the player has checked in within its expected interval. |
Adding a screen
Section titled “Adding a screen”A screen registers itself the first time the player software contacts Stratos. From your side, the workflow is:
- Install the Stratos player on the device and configure it to point at your Stratos URL.
- Refresh the Screens page. The new screen appears in the Pending Authorization callout.
- Click Authorize.
- (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.
Screen detail page
Section titled “Screen detail page”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).
Editing a screen
Section titled “Editing a screen”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.
Sending commands to a screen
Section titled “Sending commands to a screen”From the screen detail page, the Device section has action buttons:
| Action | What it does |
|---|---|
| Take Screenshot | Asks the player for a screenshot of what’s currently on screen. |
| Refresh Content | Tells the player to contact Stratos immediately and pull any pending content or schedule changes. |
| Reboot | Power-cycles the entire device. Use when the player is unresponsive. |
Commands are queued and picked up on the player’s next manifest poll.
Move to a folder
Section titled “Move to a folder”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.
Folder management and permissions
Section titled “Folder management and permissions”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.
Removing a screen
Section titled “Removing a screen”If a physical player should stop receiving content, remove it from schedules and groups or contact support for help removing it from your account.
Permissions and visibility
Section titled “Permissions and visibility”- 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.
Related
Section titled “Related”- 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.