Android Player Setup

Install the easyCMS player on an Android box or Android TV, connect it with the code it shows, and keep it running. Automatic updates, portrait screens and troubleshooting.

This guide takes an Android box or Android TV from the carton to playing your content. You need the device on your network, and a phone or computer to sign in to easyCMS. There is no address or key to type into the player: the screen shows a code, and you enter it in your account. What the app does and what it costs is on the Android digital signage player page.

What you need

  • An Android device with Android 5.0 or newer: an Android TV or Google TV box, or another Android media player. Pick dedicated player hardware rather than a bargain TV stick: signage runs all day, and cheap boxes overheat and stutter. We can also supply players set up for you.
  • A current Android System WebView. The player plays your designs through it, so an up-to-date WebView matters most on older boxes.
  • A network connection. A network cable is more reliable than Wi-Fi for a screen that stays on all day.
  • A free display licence. Your account includes one; extra lifetime licences are 99€.

Install the player

  1. On the device, open the web browser and type myeasycms.com/apk into the address bar. It always points to the current Android player, so the download starts straight away. No browser on the box? Type the same address into a downloader app.

    A browser address bar with myeasycms.com/apk typed into it

  2. Open the downloaded file, from the download notice or the Downloads list, and tap Install. The first time, Android asks whether that browser or app may install apps (Install unknown apps): allow it, go back, and the installation continues. You can switch that permission off afterwards.

  3. When it finishes, open easyCMS.

  4. On Android 10 and newer, easyCMS asks you to allow Display over other apps. Turn it on for easyCMS and go back. This is what lets the player start by itself after a power cut or a restart.

Address not working? Download the APK on a computer, copy it onto a USB stick, plug it into the box and open the file from its file manager. Then carry on from step 2.

Connect it to easyCMS

The screen now says Connect this screen to your account and shows a code and a QR code.

  1. Scan the QR code with your phone, or open the address shown on the screen. Or, in easyCMS Studio, open Add a screen.
  2. Sign in with your easyCMS login. If the code is not filled in already, type it where Add a screen asks Does the screen show a code? and press Find my screen.
  3. Type a name under What should we call this screen?, for example Reception, and press Connect.

That is all: there is nothing to press on the player. The code screen goes away by itself and the screen starts playing. Connecting uses one of your display licences; if none is free, the screen connects on a 7-day trial (see when you run out of licences).

Automatic updates

The player updates itself from easyCMS when a new version is out; you do not need to download it again.

  • Android 12 and newer: the update installs silently.
  • Rooted boxes, and boxes where easyCMS is the device owner: silently too.
  • Android 8 to 11, not rooted: Android shows its own install prompt on the screen, and someone has to confirm it there with the remote or a mouse.

Portrait screens

Set the orientation for the screen in your account, not on the box. In Studio, open the screen’s page and choose Portrait under Orientation. A screen mounted upside down has its own choices under Mounted upside down?. The player follows the orientation by itself within seconds: landscape, portrait, or either one reversed. Then give the screen designs made for portrait.

Keep it running

  • Start after a power cut: on Android 10 and newer, keep Display over other apps allowed for easyCMS (step 4 above).
  • Screen always on: turn off the box’s sleep timer and screensaver.
  • Online status: Studio’s My screens shows whether the screen is online, from anywhere. See display monitoring.

Troubleshooting

The install is blocked. Android refuses apps from outside the store until you allow them. In the box’s settings, find Install unknown apps and allow it for the browser or downloader app you used (on older Android this is Unknown sources, under Security). Then open the downloaded file again.

It does not start by itself after a power cut or a restart. On Android 10 and newer, open the box’s settings, find Display over other apps (often under Apps, Special app access), and turn it on for easyCMS.

Designs look wrong or play badly on an older box. Update Android System WebView, from the Play Store or with the box’s system update. The player plays everything through it, and an old WebView is the usual cause.

Never appears in your account, or stops checking in? Work through the offline display checklist.

Screens on the previous Android player

Screens already running the previous easyCMS Android player (v4 R412, or v3 R313) keep working as they are, and there is nothing you need to change. Those players connect with your CMS address and key and Configure Manually, as described in connecting your first display. Their files are still on the downloads page, under Previous versions.

To move one of those screens to the new player, don’t add it as a new screen: that would make a second screen and use a second licence. Instead:

  1. On the screen, install the new player from myeasycms.com/apk, as in the steps above. It shows a six-character code.
  2. In easyCMS Studio, open that screen (Screens & licences, then the screen) and choose Replace the device.
  3. Type the code from the screen.

The screen keeps its name, its licence, its designs and its schedule, and from then on it gets the easyCMS player’s automatic updates.

Related articles: Install Android digital signage in one step, Connecting Your First Display, Display Monitoring, Display Shows as Offline