Managing Players

Learn how to manage, monitor, and configure player devices that display your digital signage content.

Overview

Players are physical devices (computers, Android boxes, Raspberry Pi, LG/Samsung smart displays, etc.) that run the Castit player software to display content on screens. The Players section allows you to manage all connected player devices, monitor their status, configure settings, and troubleshoot issues.

Accessing Players

1. Log in to your Castit account
2. Click Players in the left sidebar navigation
3. View all your paired players or start the pairing process

Player Pairing Overview

When you first access the Players section with no players paired, you'll see a helpful guide:

Three-Step Pairing Process

The interface shows a visual guide with three steps:

1. Launch Castit player on your device

   • Download the player for Windows, Linux, Android, Web/PWA, or LG webOS
   • For Raspberry Pi: Use the pre-configured SD card image or the Web/PWA player
   • Install and launch the player application

2. Get the pairing code

   • A 5-digit code displays on your player device
   • QR code also available for quick scanning

3. Insert code and pair player

   • Enter the code in the web interface
   • Complete pairing to connect the player

note

For detailed pairing instructions, see the Pairing Players guide.

Players List View

Once you have players paired, the Players page displays all your devices:

Status Filters

At the top of the page, quickly filter players by status:

• ONLINE (green badge): Shows count of online players
• OFFLINE (red badge): Shows count of offline players

Click these badges to filter the list accordingly.

Player Information Table

The table displays key information for each player:

Column	Description
Name	Player name assigned during pairing
Online status	Current connection status (ONLINE badge in green or OFFLINE badge in red)
Pairing code	Unique 5-digit code for this player
Platform	Operating system/platform (Windows, Linux, Android, Web/PWA, Raspberry Pi, LG webOS, Samsung Tizen)

Searching Players

Use the search bar at the top right to find specific players by name.

Pairing a New Player

Starting the Pairing Process

1. Click the Pair player button in the top right corner
2. The pairing dialog appears

Pairing Dialog Fields

Screen to display: Select which screen this player should display

• Choose from your existing screens
• This determines what content the player shows

Player name: Give your player a descriptive name

• Example: "My latest player", "Reception Display", "Lobby Screen Player"
• Use names that identify the location or purpose

Pairing code: Enter the 5-digit code displayed on the player device

• The code appears on the physical player when launched
• Must match exactly

Completing Pairing

1. Fill in all required fields
2. Click the Pair player button
3. The player connects to your screen
4. Player appears in your players list with ONLINE status

tip

Name your players based on physical location (e.g., "Reception - Main Entrance") to make them easy to identify when managing multiple devices.

Managing Individual Players

Click on any player in the list to access its detailed management page.

Settings & Info Tab

The Settings & Info tab provides comprehensive player information and configuration:

Paired Screen

Shows which screen is currently paired with this player:

• Screen name displayed
• LATEST TAG badge indicates it's using the latest screen version
• Click to view or change the paired screen

Live Preview

See exactly what's currently displaying on this player in real-time:

• Full preview of the active content
• Updates automatically as content changes
• Useful for verifying content without physical access to the display

Notes Section

Add notes about this player:

• Physical location details
• Hardware specifications
• Maintenance records
• Contact information
• Any relevant information for your team

Click in the notes area and type to add or edit notes.

Settings & Info Panel

Availability Toggle

• Enable/disable: Controls whether the player inherits the screen's availability schedule
• When enabled: Player follows the screen's operating hours automatically
• When disabled: Player can have custom availability settings

Settings Toggle

• Enable/disable: Controls whether the player inherits the screen's settings
• When enabled: Player uses the screen's configuration automatically
• When disabled: Player can have custom settings

Location

• Physical address of where the player is installed
• Click Set location button to configure
• Helps with maintenance and management

Info Section

Displays technical information:

• Activation date: When the player was first paired (e.g., "03. Dec 2025 12:29:37")
• Screen code: Unique identifier for pairing (e.g., "46241")
• Operating system: Platform running the player (e.g., "web", "Windows", "Android")

Tags

Organize players with custom tags:

• Search for existing tags or create new ones
• Use tags like "Lobby", "Floor 2", "Critical", "Test Device"
• Filter players by tags across your organization
• Click the dropdown to add tags to this player

Top Action Buttons

Broadcast: Push immediate content updates to this player Unpair: Remove the player from the screen (requires confirmation) Preview: Open a preview window of what's displaying Other actions: Additional player management options

Availability Tab

Control when this player operates:

Inherited Availability

By default, players inherit availability settings from their paired screen:

• Message: "This player inherits availability from the screen"
• The player automatically follows the screen's schedule
• No additional configuration needed

Custom Availability

To set player-specific operating hours:

1. Click Change availability settings
2. Disable the "Player inherits availability from the screen" option in Settings & Info
3. Configure custom availability schedule for this player

Use cases for custom availability:

• Player in a location with different operating hours
• Temporary schedule changes without affecting the screen
• Energy savings for specific locations
• Maintenance windows

Report Problem Tab

If you encounter issues with a player, use the Report problem feature:

Problem Reporting Form

Question: "Do you have any issues with your screen?"

Explanation: "If you are experiencing any issues with your screen, please let us know so we can help you."

Location Field

• Enter the physical address where the screen is located
• Helps support team identify the specific installation

Hardware Type

Select the type of hardware you're using:

• PC Box (provided by us): Castit-provided player hardware
• Chromecast/Google Streamer: Google Cast devices
• Your own smart TV: Smart TV with built-in player
• Other: Other hardware configurations

Submit Form

Click the Submit form button to send your problem report to support.

tip

Provide detailed information about the issue, including:

• When the problem started
• What you've tried to resolve it
• Error messages if any
• Impact on your operations

Player Status Management

Online Players

Players showing ONLINE status are:

• Connected to the internet
• Communicating with Castit servers
• Ready to receive content updates
• Actively displaying assigned content

Offline Players

Players showing OFFLINE status may be:

• Powered off
• Disconnected from the internet
• Player software not running
• Network issues

Troubleshooting Offline Players

1. Check physical connections: Power, HDMI, network cables
2. Verify internet: Test network connectivity
3. Restart player software: Relaunch the Castit player application
4. Reboot device: Power cycle the player hardware
5. Check firewall: Ensure Castit servers aren't blocked
6. Use Report problem: Submit a support ticket if issues persist

Broadcasting Content

The Broadcast button allows you to:

• Force immediate content refresh
• Push updates without waiting for sync interval
• Verify content changes appear correctly
• Troubleshoot display issues

When to use Broadcast:

• After making content changes that need to appear immediately
• Testing new content
• Resolving sync issues
• Verifying player connectivity

Unpairing Players

To disconnect a player from a screen:

1. Open the player's detail page
2. Click Unpair in the top action bar
3. Confirm the action

What happens when unpairing:

• Player disconnects from the screen
• Content stops displaying on the player
• Player returns to pairing screen showing new code
• Player can be re-paired to same or different screen

warning

Unpairing a player will interrupt content display. The physical device will show a pairing screen until re-paired with a screen.

Best Practices

Naming Convention

Use consistent naming for easy identification:

• Location-based: "Lobby Main Entrance", "Floor 2 Breakroom"
• Function-based: "Reception Display", "Product Showcase"
• Building-based: "Building A - Lobby", "HQ - Conference Room 1"

Regular Monitoring

• Check player status daily for critical displays
• Use status filters to quickly identify offline players
• Set up alerts for offline players (if available)
• Review player notes before maintenance

Organization with Tags

Create a tagging system:

• Location tags: "Downtown", "Headquarters", "Branch-12"
• Department tags: "Marketing", "HR", "Sales"
• Priority tags: "Critical", "Standard", "Test"
• Hardware tags: "PC-Box", "Android", "Web-Player"

Documentation

Keep notes updated with:

• Installation date and installer name
• Hardware specifications
• Network information (IP, MAC address)
• Maintenance history
• Known issues or quirks
• Emergency contact information

Availability Management

• Most players should inherit screen availability
• Use custom availability only when necessary
• Document reasons for custom schedules
• Review availability settings periodically

Troubleshooting Common Issues

Player Shows Online But No Content Displays

1. Check if screen has content assigned
2. Verify player is paired to correct screen
3. Use Broadcast to force content refresh
4. Check Live preview to see if content is loading
5. Restart the player application

Pairing Code Not Accepted

• Verify all 5 digits are entered correctly
• Check player is still showing the code (not timed out)
• Restart player to generate new code
• Ensure player has internet connectivity

Content Out of Sync

• Click Broadcast to force immediate sync
• Check player's "Last seen" timestamp
• Verify network connection quality
• Review player storage space (for media files)

Settings Not Taking Effect

• Verify Settings toggle is in correct state (inherited vs custom)
• Save changes before navigating away
• Use Broadcast to push settings
• Restart player if settings still don't apply

Multiple Players on One Screen

You can pair multiple players to the same screen:

• All players display identical content
• Useful for multiple displays in same location
• Provides redundancy for critical displays
• Each player managed independently

To add additional players:

1. Click Pair player
2. Select the same screen
3. Enter new player information
4. Complete pairing

Current Plan Information

The Players page displays your current subscription plan:

• Your current plan: Shows plan name (e.g., "Essential")
• Plan determines number of players allowed
• Upgrade plan if you need more players

Getting Help

If you need assistance:

• Use the "Do you need help or more players?" button at the top
• Click Contact us! to reach support
• Use the Report problem tab for specific player issues
• Check FAQ in the left sidebar for common questions

Next Steps

• Pairing Players Guide - Detailed pairing instructions
• Screen Settings - Configure screen options
• Screen Availability - Set operating schedules
• Adding Content to Screens - Manage screen content