Player Installations

Overview

This guide will walk you through the process of installing and configuring Framebaker players for your digital signage network.

System Requirements

Before installing a Framebaker player, ensure your system meets the following requirements:

• Operating System: Windows 10/11, Linux (Ubuntu 20.04+), or macOS 11+
• Memory: Minimum 4GB RAM (8GB recommended)
• Storage: At least 20GB free disk space
• Network: Stable internet connection with minimum 10Mbps
• Display: HDMI or DisplayPort output

Installation Steps

1. Download the Player Software

1. Log in to your Framebaker partner portal
2. Navigate to the Downloads section
3. Select the appropriate installer for your operating system
4. Download the latest stable version

2. Install the Player

Windows Installation

# Run the installer with administrative privileges
.\FramebakerPlayerSetup.exe /S

Linux Installation

# Extract and install the package
sudo dpkg -i framebaker-player.deb
# Or for RPM-based systems
sudo rpm -i framebaker-player.rpm

macOS Installation

# Mount the DMG and copy to Applications
hdiutil attach FramebakerPlayer.dmg
cp -R /Volumes/Framebaker/Framebaker.app /Applications/

3. Initial Configuration

After installation, configure your player:

1. Launch the Framebaker Player application
2. Enter your License Key (provided by Framebaker)
3. Configure the Display Settings:
   • Resolution
   • Orientation (landscape/portrait)
   • Screen position
4. Set up Network Settings:
   • DHCP or static IP
   • Proxy settings (if required)
5. Configure Playback Settings:
   • Content refresh interval
   • Fallback content
   • Scheduling options

4. Registration

Register your player with the Framebaker cloud:

// Example registration payload
{
  "licenseKey": "YOUR-LICENSE-KEY",
  "playerName": "Reception-Display-01",
  "location": "Main Office - Lobby",
  "timezone": "Europe/Amsterdam"
}

Troubleshooting

Player Won’t Start

• Check system requirements are met
• Verify license key is valid
• Ensure firewall allows Framebaker connections
• Check log files in /var/log/framebaker/ (Linux) or C:\ProgramData\Framebaker\Logs (Windows)

Display Issues

• Update graphics drivers
• Verify display resolution is supported
• Check HDMI/DisplayPort cable connections
• Try different display outputs

Network Connectivity

• Test internet connection
• Verify firewall rules allow outbound HTTPS (port 443)
• Check proxy settings if applicable
• Ensure DNS resolution is working

Advanced Configuration

Command Line Options

# Start player with custom config
framebaker-player --config /path/to/config.json

# Enable debug mode
framebaker-player --debug --log-level verbose

# Set custom cache directory
framebaker-player --cache-dir /mnt/cache

Configuration File

Edit the configuration file located at:

• Linux: /etc/framebaker/player.conf
• Windows: C:\ProgramData\Framebaker\player.conf
• macOS: /Library/Application Support/Framebaker/player.conf

{
  "player": {
    "id": "unique-player-id",
    "name": "Display Name",
    "updateInterval": 300,
    "enableHardwareAcceleration": true,
    "logLevel": "info"
  },
  "display": {
    "resolution": "1920x1080",
    "orientation": "landscape",
    "refreshRate": 60
  },
  "network": {
    "timeout": 30,
    "retryAttempts": 3,
    "proxy": null
  }
}

Next Steps

• Configure your content playlists
• Set up scheduling rules
• Monitor player health and status
• Update firmware regularly

For additional support, contact your Framebaker partner manager.