Quick Start Guide: Revel Digital AppImage Player on Raspberry Pi

Overview

This guide walks you through installing and configuring the Revel Digital AppImage player on a Raspberry Pi device. The AppImage format provides a self-contained, portable application that runs on most Linux distributions without additional dependencies.

Prerequisites

Hardware Requirements:

• Raspberry Pi 3B, 3B+, 4, or 5 (recommended: Pi 4 or 5 with 2GB+ RAM)
• MicroSD card (16GB minimum, Class 10 recommended)
• Power supply appropriate for your Pi model
• HDMI display
• Internet connection (Ethernet recommended for reliability)

Software Requirements:

• Raspberry Pi OS (64-bit recommended) or Ubuntu
• SSH access or keyboard/mouse for initial setup

Installation Steps

In a hurry? Try the script, otherwise follow the steps below.

wget https://reveldigital-common.s3.us-east-1.amazonaws.com/raspi/setup.sh
chmod +x setup.sh
./setup.sh

Step 1: Prepare Your Raspberry Pi

Ensure your Raspberry Pi is running the latest version of Raspberry Pi OS. Update your system before beginning:

sudo apt update
sudo apt upgrade -y

Install required dependencies for AppImage execution:

sudo apt install fuse libfuse2 -y

Step 2: Download the Revel Digital AppImage

Download the latest Revel Digital player AppImage for ARM64 architecture. You can do this directly on the Pi or download to another computer and transfer via SCP.

Option A: Direct Download on Pi

cd ~/Downloads
wget https://reveldigital.com/downloads/player/revel-digital-player-arm64.AppImage

Option B: From Revel Digital Versions

Navigate to https://versions.reveldigital.com/linux and download from the AppImage build

Step 3: Make the AppImage Executable

Navigate to the directory containing the AppImage and set executable permissions:

chmod +x revel-digital-player-arm64.AppImage

Step 4: Run the Player

Launch the player for the first time:

./revel-digital-player-arm64.AppImage

The player will start and display a registration code on the screen.

Step 5: Register Your Device

1. Log into your Revel Digital account at https://as1.reveldigital.com
2. Navigate to Devices → Add Device
3. Select AppImage Player as the device type
4. Enter the registration code displayed on your Pi's screen
5. Assign a name and location to your device
6. Click Register

Your device will appear in your device list and begin downloading assigned content within a few moments.

Running Player on Startup

To configure the player to start automatically when your Raspberry Pi boots:

Create a Systemd Service

Create a new service file:

sudo nano /etc/systemd/system/revel-player.service

Add the following content (adjust the path to match your AppImage location):

[Unit]
Description=Revel Digital Player
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=pi
Environment=DISPLAY=:0
ExecStart=/home/pi/Downloads/revel-digital-player-arm64.AppImage
Restart=always
RestartSec=10

[Install]
WantedBy=graphical.target

Save and exit (Ctrl+X, then Y, then Enter).

Enable and start the service:

sudo systemctl daemon-reload
sudo systemctl enable revel-player.service
sudo systemctl start revel-player.service

Check the service status:

sudo systemctl status revel-player.service

Configuration Tips

Display Settings: Configure your display resolution in Raspberry Pi settings for optimal output:

sudo raspi-config

Navigate to Display Options → Resolution and select your preferred resolution.

Disable Screen Blanking: Prevent the screen from going blank during playback:

sudo nano /etc/xdg/lxsession/LXDE-pi/autostart

Add these lines:

@xset s off
@xset -dpms
@xset s noblank

Network Configuration: For production deployments, use a wired Ethernet connection for reliability. If WiFi is necessary, configure it through raspi-config or network manager.

Troubleshooting

Player won't start:

• Verify FUSE is installed: fusermount --version
• Check AppImage permissions: ls -l revel-digital-player-arm64.AppImage
• Review system logs: journalctl -u revel-player.service -n 50

Registration code not appearing:

• Ensure the device has internet connectivity
• Check that DISPLAY variable is set correctly
• Verify no other display managers are interfering

Content not downloading:

• Confirm device registration in the Revel Digital portal
• Check firewall settings (the player needs outbound HTTPS access)
• Verify system time is synchronized: timedatectl status

Performance issues:

• Use Raspberry Pi 4 or 5 for HD/4K content
• Reduce content complexity or resolution if experiencing lag
• Monitor system resources: htop

Updating the Player

The player will automatically check for new versions and download in the background. Restarting the app is necessary to complete the install.

To manually update the player to a new version:

1. Download the latest AppImage
2. Stop the existing player service: sudo systemctl stop revel-player.service
3. Replace the old AppImage with the new one
4. Update the service file path if the filename changed
5. Restart the service: sudo systemctl start revel-player.service

Support

For additional assistance:

• Visit the Revel Digital Knowledge Base: https://support.reveldigital.com
• Contact support: support@reveldigital.com
• Check system status: https://status.reveldigital.com

Best Practices

• Use a quality power supply rated for your Pi model to prevent stability issues
• Enable automatic updates for Raspberry Pi OS security patches
• Use a high-quality, fast microSD card (Application Class A1 or A2)
• Consider read-only filesystem configurations for kiosk deployments
• Keep a backup image of your configured SD card
• Monitor device health through the Revel Digital portal

Last Updated: November 2025