Overview

If something isn't right with your Legacy Android player, this guide walks through the most common issues.

1. What Is the Legacy Android Player?

Yodeck's original APK for Android devices that don't support the Google Play Store and run Android 5-7. Updates are manual: you install new APK builds yourself.

Is this the right guide for you?

Device on Android 8 or later running an APK: see the Android APK v2 Player Troubleshooting Guide.
Yodeck app installed from the Google Play Store: see the Android Play Store App Troubleshooting Guide.

How to confirm you're on the Legacy player: the device runs Android 5, 6, or 7, the Yodeck app was installed as a standalone APK, and the registration code starts with 3. (APK v2 also uses prefix 3. If your device is on Android 8 or later, you're likely on APK v2.)

ℹ️ Where possible, upgrade compatible devices to Android 8 or later and switch to APK v2 Production Setup for better performance, automatic updates, and remote management.

2. Things the Legacy Android Player Cannot Do

Feature	Supported?	Remote reboot/shutdown
Automatic updates	❌ No	Install new APK builds manually
Turn the screen on/off remotely via CEC	❌ No	The screen turns black instead
YouTube Live and Vimeo Live	❌ No	Pre-recorded videos play normally
Google Chromecast (original)	❌ No	Chromecast with Google TV is supported
Apps with custom script code	❌ No	See the App Compatibility Table
Custom scripts on web pages	❌ No
Webpage layering in layouts	❌ No	Webpages always render on top
Sound output selection	❌ No	Audio plays through the device's default output
USB to HDMI Video Capture	❌ No
Security Configurations (SSH, custom certificates)	❌ No
Custom Boot Logo	❌ No
Remote reboot / shutdown	⚠️ Advanced Setup only	Requires Device Owner privileges
Remote timezone configuration	⚠️ Advanced Setup only	Requires Device Owner privileges
Kiosk Mode	⚠️ Advanced Setup only	Requires Device Owner privileges

3. What Do the On-Screen Messages Mean?

Message	What It Means	What To Do
Registration Code	The player needs to be linked to your Yodeck Portal	Enter the 9-digit code in Screens > +Add Screen > Android Player (Android 7 or earlier)
Downloading	The player is receiving new content	Wait. If it takes more than 5 minutes, check your internet
Internet Access Required	Offline for 30+ days, deleted and re-registered, or storage was swapped	Check the Last Online date. Reconnect to the internet
Apply Needed	Schedule file expires within 3 days	Click Push to Players right away
Device Deactivated	The screen quota was reduced	Upgrade your plan or delete unused screens
No Content Assigned to Player	No Playlist, Layout, or Schedule assigned	Assign content and click Save & Push

4. Registration Code Not Appearing?

Check your internet connection. Wait 30 to 60 seconds after connecting.
Reboot the device. Wait 2 minutes.
Reinstall the latest APK if needed (see Section 16).
Check storage. Minimum 500 MB of free space is required.
Confirm a supported Android version (5, 6, or 7).

5. Blank or Black Screen Issues

After a fresh installation, with no registration code visible

Confirm all required permissions were granted.
Confirm the Content module and Demo mode were enabled (Simple Setup).
Confirm at least 500 MB of free storage.

If the screen is still blank, uninstall and reinstall the latest APK.

During normal operation, after the player was working fine

If the player is Online, wait up to 3 minutes for a fresh screenshot. Verify the screen is on, set to the correct HDMI input, and has a Schedule or Default Content assigned.

If the player is Offline, check the Last Seen Online date. If older than 30 days, the device may have been auto-disabled. Reboot and check whether it comes back online.

To isolate content vs network issues: Create a new Layout with a simple full-screen image (no expiration). Set the Assigned Schedule to None and the new Layout as Default Content. Click Push to Players. If the screen still shows Downloading after 5 minutes, it's a network issue (Section 6). If the screen recovers, it's a content or scheduling issue.

6. Player Shows as "Offline" in the Portal

Step	What To Do
1. Test your internet	Confirm that another device on the same network can browse normally
2. Reboot the device	If it drops again after 15 to 20 minutes, contact Yodeck Support
3. Switch to wired	If on Wi-Fi, try Ethernet
4. Check for an HTTP proxy	Proxies can block player communication
5. Check the firewall	Add an exception for the player's MAC address. Boot without a network to display the MAC
6. Confirm required ports	See the Network Ports article
7. Check for a captive portal	The network admin must add the device's MAC address to the allow list

If the player has no IP address, temporarily connect via Ethernet, then use the Wi-Fi wizard to reconnect wirelessly.

7. Content Not Updating on Screen

Symptom	Likely Cause	Fix
The screen is blank	No content assigned, or no active schedule rule	Assign content and click Push to Players
"No Content Assigned" error	No Playlist, Layout, or Schedule assigned	Edit the screen, assign content, and click Save & Push
Wrong content playing	A Schedule is overriding the Default Content	Review the Schedule and confirm which rule is active
Content is updated, but the screen didn't change	Push to Players was not clicked	Always click Push to Players after editing
Content downloading for 5+ minutes	Network issue or web filtering	See Section 6

ℹ️ Schedules take priority over Default Content during active time slots.

8. Video Playback Issues

Symptom	Fix
Video stutters or lags	Reduce video resolution and bitrate. Older hardware has limits
Video shows an error or won't play	Re-upload in MP4 (H.264)
Video plays standalone but not inside a Layout	Reduce the number of zones or widgets in the layout

Recommended video specs: MP4 container, H.264 codec, AAC audio, 1080p at 30 fps maximum. 4K is not recommended.

9. No Sound / Audio Issues

Sound output selection (HDMI, Analog, Muted) is not supported. Audio plays through the device's default output.

Check that volume isn't muted or set to zero.
Verify the HDMI cable supports audio passthrough.
Confirm the media file has an audio track.

10. YouTube and Streaming Issues

Stream Type	Supported?
YouTube and Vimeo (pre-recorded)	✅ Yes
HLS streams (HTTPS)	✅ Yes
DASH streams	✅ Yes
YouTube Live, Vimeo Live	❌ No
RTMP / RTSP, UStream	❌ No

Symptom	Fix
The YouTube video shows an error	Try a different video
Streaming buffers constantly	Check connection speed. Older hardware may struggle with high-bitrate streams
HLS stream won't play	Switch to an HTTPS version

💡 If you rely on YouTube content, download the videos and upload them directly to Yodeck. Older hardware handles local media more reliably.

11. Webpage Display Issues

Webpages display above all other content in the same region, regardless of layering order.

Symptom	Fix
Webpage looks broken or doesn't load	Try a different URL, or screenshot the page and use it as an image
The webpage shows a login screen	Use a publicly accessible URL
Custom scripts don't run	Not supported. Use a static version of the page
Webpage layout broken	The older browser engine doesn't support all modern CSS or JavaScript. Use a simpler page, or build content in Yodeck directly

💡 The Legacy player uses an older browser engine. For reliable results, use Yodeck's built-in apps (such as Notice Board, Social Wall, and similar).

12. Scheduling and Timezone Issues

The Legacy Android player supports remote timezone configuration only on Advanced Setup (Device Owner). On Simple Setup, the device uses its OS-level time settings.

Symptom	Fix
Content plays at the wrong time	On Advanced Setup, set the timezone in the Portal. On Simple Setup, set it in the Android system settings
The schedule doesn't activate	Confirm the Schedule is assigned, then Save & Push
Default content plays during the scheduled time	Review the schedule rules
The schedule worked before, but stopped	Bring the player online and click Push to Players

ℹ️ A Schedule takes priority over Default Content during its active time slots.

13. Registration and Account Issues

Registration code prefix: 3 (same as APK v2). If your device is on Android 7 or earlier, you're on the Legacy player.

Symptom	Fix
"Player Already Registered"	Contact Yodeck Support
"Registration code does not match player type."	In +Add Screen, choose Android Player (Android 7 or earlier)
Registration code not appearing	Confirm internet access. Try Ethernet
The code shows briefly, then a black screen	Reconnect to the internet. The code will reappear

14. Kiosk Mode (Advanced Setup)

Kiosk Mode locks the device to the Yodeck app only. It's available on the Legacy Android player only when installed using Advanced Setup with Device Owner privileges.

To enable Kiosk Mode: open the Portal, go to the screen's settings, toggle Kiosk Mode on, and click Save & Push to this Screen.

Auto-start after power loss: Most devices restart with the Yodeck app automatically. If yours doesn't, enable auto-start for the Yodeck app in the device's Auto-start or Startup Manager settings.

⚠️ Kiosk Mode is not available on Simple Setup installations. To enable it, factory reset the device and reinstall using Advanced Setup.

15. NTP Server Configuration

The Legacy Android player (latest APK build) supports custom NTP server configuration for accurate time synchronization. This is useful when the device cannot reach public NTP servers.

To configure NTP servers, see our NTP Configuration for Android guide. If the option isn't visible, update the APK to the latest version.

16. Factory Reset and Reinstalling the Yodeck App

The Legacy Android player does not auto-update. Reinstall the APK manually when a new version is released.

Situation	What to Do
The Yodeck app is crashing	Reboot. If it persists, uninstall and reinstall the latest APK
You want to update the Yodeck app	Download the latest APK and reinstall over the existing version. Your registration is preserved
You want to start over	Factory reset through Android settings, then reinstall the Yodeck APK
The old screen still shows in the Portal	Delete it from the screens, then register again using the new code

⚠️ If the device was set up with Advanced Setup (Device Owner), a factory reset is required to fully remove the Yodeck app. Simple Setup installations can be uninstalled normally.

Installation methods:

Android TV: Send the APK from a phone using the Send Files to TV app, then install with FX File Explorer.
Tablets and other devices: Download the APK directly and install it.
White-label partners: Find the latest unbranded APK in the Partners Console.

17. Supported Devices

The Legacy Android player runs on older Android devices without access to the Google Play Store.

Minimum requirements:

Android 5, 6, or 7
At least 500 MB of free storage
Network connectivity (Wi-Fi or Ethernet)

Supported categories: older Android TVs without Play Store access, older Android tablets, phones, and signage boxes, and professional series displays from Sony Bravia Professional and Sharp ME (RDM supported, see our setup guides).

⚠️ The Legacy Android player is in maintenance mode. New features ship on the APK v2 player. Where possible, upgrade compatible devices to Android 8 or later and switch to APK v2 Production Setup.

For the latest list of tested devices, visit our Android Supported Devices page.