Pairing Screens

Learn how to connect and pair your screens with the Screenzzie platform

Pairing Screens

Connecting your screens to Screenzzie is simple and secure. This guide covers everything you need to know about the pairing process.

How Pairing Works

Screenzzie uses a secure 6-digit code system to pair screens. The code is generated on the TV/display itself, ensuring that only someone with physical access can initiate pairing:

  1. Your TV/display navigates to the activation page
  2. A unique 6-digit code appears on the screen
  3. You enter this code in your Screenzzie dashboard
  4. The screen connects securely to your account

Pairing codes expire after 15 minutes for security. If your code expires, simply refresh the page on your TV to get a new one.

Pairing a New Screen

Step 1: Generate Code on Your Display

On your TV or display device:

  1. Open a web browser
  2. Navigate to play.screenzzie.com/activate
  3. A 6-digit pairing code will appear on screen
  4. Keep this screen visible while you complete the next step

Player URLs by Environment:

  • Production: play.screenzzie.com/activate
  • Development: play-dev.screenzzie.com/activate
  • Self-hosted: Your custom domain + /activate

Step 2: Enter Code in Dashboard

  1. Log in to your Screenzzie dashboard
  2. Navigate to Screens in the sidebar
  3. Click Add Screen
  4. Enter the 6-digit code from your TV
  5. Give your screen a descriptive name (e.g., "Reception TV", "Menu Board 1")
  6. Click Pair

The screen will immediately connect and show a confirmation message.

Using the Screenzzie Player App

If you're using our dedicated player app:

  1. Launch the Screenzzie Player app
  2. The activation screen appears automatically with a 6-digit code
  3. Enter this code in your dashboard as described above

Re-Pairing an Existing Screen

If you need to reconnect a screen that was previously paired (e.g., after replacing hardware):

Method 1: From the TV (Recommended)

  1. On the new device, go to play.screenzzie.com/activate
  2. A new 6-digit code appears
  3. In your dashboard, you can either:
    • Delete the old screen and add a new one with the code
    • Use the existing screen's settings to re-pair

Method 2: From the Dashboard

For screens that are already in your dashboard but need to be re-paired:

  1. Go to Screens and click on the screen
  2. Navigate to the Settings tab
  3. Click Generate New Pairing Code
  4. A code will appear in the dashboard
  5. On your TV, go to play.screenzzie.com/activate
  6. Enter this dashboard-generated code on the TV

Dashboard-generated codes are for re-pairing existing screens only. For new screens, always start from the TV to generate the code.

Compatible Devices

Screenzzie works with a wide range of devices:

Device TypeRecommended ForSetup Difficulty
Android TVHome, small businessEasy
Fire TV StickBudget setupsEasy
Raspberry PiDIY, multiple screensMedium
Windows PCHigh-performanceEasy
Chrome devicesEnterpriseEasy

Configuring After Pairing

Once paired, you can configure your screen:

  1. Go to Screens and click on your screen
  2. In the Settings tab:
    • Orientation: Portrait or Landscape
    • Rotation: 0, 90, 180, or 270 degrees
    • Group: Assign to a screen group
    • Timezone: Set for accurate scheduling
  3. In the Content tab:
    • Assign a playlist or sequence
    • Configure overlays (clock, weather, announcements)
  4. Click Save

Troubleshooting Pairing Issues

Code Not Working

  • Verify the code is entered correctly (watch for 0 vs O, 1 vs I)
  • Check if the code has expired (15-minute limit)
  • Refresh the page on your TV to get a new code

Code Expired

  • Simply refresh the browser page on your TV
  • A new 6-digit code will appear
  • Enter the new code in your dashboard

Screen Not Connecting

  • Ensure the device has internet access
  • Check firewall settings (ports 443 and 80 must be open)
  • Try a different browser or clear cache
  • Verify you're using the correct player URL for your environment

Screen Shows Offline

  • Verify network connectivity on the display device
  • Restart the player device
  • Check if the screen was revoked in dashboard
  • Try refreshing the player page

Security Features

Your screens are protected by:

  • Secure token authentication - Each screen has a unique token
  • Encrypted connections - All data is transmitted over HTTPS
  • Time-limited codes - Pairing codes expire after 15 minutes
  • Physical access required - Only someone at the TV can initiate pairing
  • Session management - Revoke access anytime from dashboard
  • Auto-refresh - Tokens refresh automatically

Managing Paired Screens

After pairing, you can:

  • Rename - Update the screen name
  • Move - Assign to different groups
  • Configure - Set orientation, content, and schedules
  • Revoke - Disconnect the screen

To revoke a screen's access:

  1. Go to Screens
  2. Click on the screen
  3. Go to Settings tab
  4. Click Revoke Access

Revoking access will immediately disconnect the screen. You'll need to re-pair to reconnect.

Next Steps