Before troubleshooting, it is important to know which type of Android player your device is running. Different variants have different capabilities and limitations.
​
💡The Android player type titles of this table below ⬇️are clickable hyperlinks which redirect you to the related troubleshooting guide article of each Android player type.

How to identify which setup a device is using:

💡Always confirm the player type before troubleshooting. Steps for Device Owner mode do NOT apply to the Play Store App or Legacy APK v1.

Latest APK v2 versions (as of April 2026):

The following features are not supported on Android players. These are by design and should not be treated as bugs.

Use this table to quickly identify what an on-screen message means and what to do next.

ℹ️Note: "Internet Access Required" can persist for up to 45+ days after going offline. A reboot may restore playback for up to 1 hour before the message returns.

Symptom: The Yodeck app launches after a fresh installation but only shows a blank or black screen, with no registration code or content displayed.

If your device has an outdated version of Android System WebView, the Yodeck app will launch but display only a blank screen.

How to fix it — Update Android System WebView:

If the device is stuck on the Android loading screen and cannot be recovered remotely, perform a factory reset followed by a fresh APK v2 installation.

Symptom: The player was working fine but now shows a black screen.

If the player is ONLINE:

If the player is OFFLINE:

If no media is available in the playlist after a layout expires, the screen will go black. Always use playlists (not direct layout assignments) and check expiration dates on all media items.

Work through these checks in order:

If the player has no IP address:

If the player has an IP address but still cannot connect:

ℹ️Note: Schedules take priority over Default Screen Content during active time slots. Always check both the Schedule AND the Default Content assignment when troubleshooting playback issues.

Symptom: The Yodeck app fails to install, or the Device Owner setup step fails during the APK v2 production setup.

Before proceeding, verify that your device does not have another app or account (such as a Google Account) set as the "device owner." Your Android device must be free of any connected accounts, including Google Accounts. If there is an account signed in, sign out before attempting the setup again.

⚠️ Important: Once the Production Setup is completed, the app will fully control the device. To remove it, you will need to perform a factory reset.

Android players use Android System WebView to render web content, apps, and the Yodeck interface itself. An outdated or incompatible WebView version is one of the most common causes of blank screens and rendering failures.

Based on troubleshooting for a partner's screen, we identified an issue where if the device has an outdated system WebView app, the Yodeck player will launch and only show a blank screen.

Signs of a WebView issue:

ScreenCloud bundles Chromium/Chrome inside their app, so they don't have compatibility issues on older Android versions with old WebView. This is something to investigate so we can work with Chinese manufacturers that may have Android 7 or 10 without browser engine restrictions. This is on the engineering roadmap but not yet implemented.

On Android players, webpages are always rendered on top of all other content within a region. This behavior is fixed and applies regardless of the layering order defined in the layout. As a result, webpages cannot be layered behind or between other media items on Android devices.

This is a known limitation, not a bug. Do not escalate.

On Android APK 2.0, in order to display a webpage we use an external Webview window instead of an iframe (that we used in 1.0). This way we don't allow transparency for webpages.

A viewport fix for webpages was included in APK v2.1.1 (Sprint-211, released 23 December 2025). Ensure the device is on this version or later if webpages appear incorrectly scaled.

The Chromium WebView we are using to render the videos has issues with the vertical orientation in some chipsets. If a customer reports video lagging in a specific orientation, check the device chipset. A firmware or software update from the device manufacturer may help. Bundling a specific Chromium WebView is on the engineering roadmap.

All players use local storage to download and store the media you push. If you push several media simultaneously with their total size larger than the available storage, your player will fail to download the new media. In such case, your screen will display a red text message at the bottom right corner: "No Space Left."

What happens: The player status in the Portal will show "Downloading." The player will not change its playback and will keep playing the old media.

Insufficient disk space (less than 500 MB available) is one of the identified storage problems that can prevent the app from working correctly.

Kiosk Mode locks a device to a single app, in our case, the Yodeck app, which prevents the misuse of a tablet when customers have physical access to it.

⚠️ Note: Kiosk mode is supported in APK v1, not yet in APK v2. It needs Device Owner access and is currently under investigation for the v2 player.

We have built the ability to set Yodeck as the home app, and then it works a bit like kiosk mode — the back and home buttons don't work. This is not a full kiosk lock but reduces accidental navigation.

Third-party kiosk apps (SureLock, KioWare, Fully Kiosk Browser) have not been tested by Yodeck and are not officially recommended.

In power loss, most devices auto-start with the Yodeck app. Please manually set up the Yodeck app as the auto-start if your device doesn't.

How to set Yodeck as the auto-start app:

All players can access videos in formats such as YouTube, HLS, and DASH. However, UStream, custom HLS, and RTMP/RTSP streams are exclusive to Pi players. Additionally, these streams must be delivered in H.264 format to ensure compatibility with Yodeck Players.

⚠️ Important: Android does not have native streams like the Raspberry Pi. It uses the web player engine, so if a stream doesn't play in the web player, it won't play on Android either.

If an HTTP stream is not playing on Android, try switching to an HTTPS version of the stream URL. Android's WebView enforces stricter security policies than the Raspberry Pi player.

Yodeck supports many popular audio format types: AAC, MP4, M4A, MP3, OGA, OGG, WAV, OPUS.

Standard Video Formats: mp4, avi, mov, mkv, webm, wmv, flv, mpeg, ts. Mobile & Streaming Formats: 3gp, 3gpp, x-m4v, m4v, quicktime.

After seeing the registration code on your Android TV screen or device, you must register the player to your Yodeck Account: Log in to your Yodeck Account, go to the Screens section, click +Add Screen, choose the Android Player option, type in the 9-digit registration code, and click Save. After a minute, your player should register.

Registration Code Prefixes for Android:

Registration Code Prefix 3 = Android (APK). Prefix 8 = Android (Play Store).

When you delete a screen, any players associated with that screen will be de-registered. This means the players will no longer be connected to your Yodeck account, and a message on the screen will be displayed prompting registration.

If you downgrade your subscription without first deleting any extra screens, Yodeck will automatically deactivate the last screens you added in order to match your new subscription limit. The screens will no longer be active and display a message prompting registration. You can reactivate these screens by deleting the ones you no longer need.

The Yodeck Support Team can help you out! Log in to your Yodeck account and send us a message from the bottom right corner!