Table of Contents
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.
Need Help?
The Yodeck Support Team can help you out! Log in to your Yodeck account and send us a message from the bottom right corner!