How to reflash your Yodeck player

Reflashing the SD card using the Etcher program

Step by step procedure:

  1. Download the latest Yodeck SD card image
  2. Unzip the zip file you downloaded and save the unzipped image file on your hard drive. 
    • 💡It should be a single IMG file of about 3.2GB in size.
  3. Download Etcher and install it. Etcher is an awesome SD card image writing/verification tool that works on Windows, Mac, and Linux.
  4. Power off the player, remove the SD card from the Yodeck Player, put it into your SD card reader, and insert it into your PC/Laptop.
    • 💡If any windows pop up on your screen upon placing the SD card on your PC/Laptop, ignore them and close all of them.
  5. Run Etcher, select the unzipped Yodeck image file from your hard drive, select the SD card to write the image to, and then click the “Flash!” button.
  6. After Etcher completes, it will prompt you to remove the SD card. Remove the SD card and place it back into the Yodeck player.
  7. Connect your Yodeck Player via HDMI to your TV/Monitor and connect it with an Ethernet cable.
    • 💡If you don’t have an Ethernet cable to use and want to use a WiFi connection instead, please follow this guide.
  8. Power up the Yodeck Player and wait for the initialization process to complete. It may take up to 5′ to finish.
  9. Upon completion, you should see a message on the screen connected to the Pi, showing either a Registration Code or a message with a connectivity error (in case there is no Internet access).
  10. Ensure you do not remove the Yodeck player’s power plug until you see one of these message screens. At all times, if the player is showing a blinking message in the bottom-right corner of the screen (“Loading”, “Configuring”, “Downloading”, etc.), you should not remove power to minimize the risk of interrupting a critical procedure.

Reflashing the SD card using the USB method (Recommended)

USB

The Player is resilient to hardware and system failures. But, as with any device, there is a slight chance that the Player may fail.

In the case of a software failure, you might be able to recover your Player by ” reflashing” it with the latest software. Reflashing will erase all of the Player’s content (re-writing the whole SD card from scratch). Your settings will be retained, so your Player should re-apply all settings in the system, re-download all content required and resume playback without you doing anything.

If you are an advanced user, keep in mind that the only thing retained from the existing content is the ” SETTINGS.txt” file containing all settings. Any manual changes you have made to the image through the command line will be lost ( e.g., manually changing passwords, changing config.txt manually, adding other software, etc.).

Preparing the USB flash drive

To perform this procedure, you will need a USB flash drive.

Here are the requirements and some info on this:

  1. It would be best to use a FAT32-formatted flash drive (most USB flash drives are by default formatted as FAT32). ext2/3/4 also works, and NTFS might also work.
  2. The Yodeck Player does not change anything on the flash drive, so you can leave any other files you have on the stick.
  3. Download the latest Yodeck SD card image zip file (about 1.1GB in size).
  4. ⚠️DO NOT RENAME OR EXTRACT THE ZIP FILE! Copy it (as is) into the base folder of the USB flash drive.
    extract

Reflashing your Player

After you have prepared a USB flash drive, follow these instructions to recover your Player:

  1. Plug the USB flash drive that you have prepared using the above steps into any of the Player’s 4 USB ports.
    USB
  2. Power up (or reboot) the Player.
  3. Upon start-up and before showing the Yodeck logo, the Player always displays a message saying Searching for USB drives… while searching for the flash drive.
  4. The Player will find the flash drive, and it should display a message saying USB drive detected.”
  5. If the Player does not show the USB drive detected” message, you will need to use a different USB flash drive because it cannot detect the flash drive you used.
  6. The verification and writing procedure should start as described above if you have prepared the USB flash drive correctly. If you get any error messages, check that you have properly prepared the USB flash drive.
  7. At this point,
    1. ⚠️DO NOT REMOVE POWER FROM YOUR PLAYER! 
    2. ⚠️DO NOT REMOVE THE USB DRIVE!
      Allow the procedure at least 30′ to complete.
  8. When the procedure has been completed, you will be prompted to remove the USB drive. Once you remove it, the Player will automatically reboot. After reboot, the Player will re-apply all retained settings in the system.
  9. The software might also need to be updated online, so make sure you do not unplug the Player to ensure everything is completed smoothly.
  10. Please allow enough time for it to perform all the required initialization procedures. Allow at least 15-20 minutes before worrying if nothing comes up.

After the procedure is completed, your Player should recover, connect to the Internet, and start downloading content. Eventually, it will start playback!


Security Notice

For the advanced IT security-aware readers:
Yodeck Player Image files are digitally signed. The ZIP files contain information that verifies that Yodeck issued the specific SD card image. You cannot perform this procedure with an arbitrary image file, so an attacker cannot inject their own code into the system just by plugging in a USB drive and rebooting.