Documentation
Comprehensive guides and reference documentation for PixelSuite.
Device Management
The Device Management page shows all signage devices registered to your account. Devices connect to Pixelsuite via MQTT and report their status in real time.
Device Status Overview
Four status counts are shown at the top of the page and can be clicked to filter the device list:
| Status | Description |
|---|---|
| Total | All active and stale devices. |
| Online | Devices that are actively connected and responsive. |
| Offline | Devices that are not currently connected. |
| Stale | Devices that have not reported in for an extended period. |
Device List
The device table shows:
| Column | Description |
|---|---|
| Status indicator | Animated dot: green/pulsing = online, grey = offline. |
| Device Name | The device's label (custom name if set, otherwise device-reported name) and hostname. |
| Type | Detected from the operating system: SignOS, Android, Raspberry Pi, Linux, Windows, macOS, or Unknown. |
| Status | Online / Offline / Stale badge. |
| Channel | The channel this device is assigned to (linked to the channel profile if you have permission). |
| Location | Physical location as recorded on the device. |
| App Version | Pixelsuite app version running on the device. |
| Last Activity | How long ago the device last reported in (relative time + full timestamp). |
Filtering Devices
Use the filter toolbar to narrow the list:
- Search — Filter by device name, hostname, or location.
- Channel — Filter to show only devices assigned to a specific channel.
- Status buttons — Show All, Online only, Offline only, or Stale only.
Admin Actions
The following actions are available to administrators only:
Rename Device
Set a custom label for a device. Leave blank to revert to the device's reported name. Maximum 255 characters.
Delete Device
Remove a device from the account. Note: if the device is still active and connected, it will re-appear automatically on its next MQTT connection.
Pair New Device
Pairs a new physical device to the account and assigns it to a channel. Requires the account to have an API key configured.
Pairing process:
- The device's screen displays a 6-digit pairing code.
- Enter the 6-digit code into the pairing modal.
- Select the channel to assign the device to.
- Click Pair Device.
- On success, the device GUID and assigned channel are shown. The page auto-refreshes after a short countdown.
Device Types
Device type is automatically detected from the operating system version string reported by the device:
| Type | Detection |
|---|---|
| SignOS | Reported OS contains "signos" or "sign os" |
| Android | Reported OS contains "android" |
| Raspberry Pi | Reported OS contains "raspbian" or "raspberry" |
| Linux | Reported OS contains "linux" |
| Windows | Reported OS contains "windows" or "win" |
| macOS | Reported OS contains "darwin" or "macos" |
| Unknown | No match |