Page tree
Skip to end of metadata
Go to start of metadata

Reflashing the SD card using the Etcher program

  1. DOWNLOADDownload the latest Yodeck SD card image

  2. Unzip the zip file you downloaded and save the unzipped image file on your hard drive.
    (lightbulb)If you don't know how to unzip a file, please check this guide here

  3. Download Etcher and install it. Etcher is an awesome SD card image writing/verification tool that works on Windows, Mac, and Linux.
    (lightbulb)If you don't know what Etcher is, please check this guide here.

  4. Remove the SD card from the Raspberry Pi, put the SD card into your SD card reader, and insert it into your PC/Laptop.
    (lightbulb)If any windows pop up on your screen upon placing the SD card on your PC/Laptop, ignore them and close all of them. 
    SD card reader

  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.
    (lightbulb)Etcher will automatically detect your SD card on your PC/Laptop.

  6. After Etcher completes, it will prompt you to remove the SD card. Place the SD card back in the Raspberry Pi.
    insert SD card

  7. Connect your Raspberry Pi via HDMI to your TV/Monitor and connect it with an Ethernet cable.
    (lightbulb)If you don't have an Ethernet cable to use and want to use a WiFi connection instead, please follow this guide.
    player's cable connection

  8. Power up the Raspberry Pi and wait for the initialization process to complete. It may take up to 5'-10' 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 power from the Raspberry Pi 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


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 a USB flash drive

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

Here are the requirements and some info on this:

  • 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.
  • The Yodeck Player does not change anything on the flash drive, so you can leave any other files you have on the stick.
  • DOWNLOADDownload the latest Yodeck SD card image zip file (about 1GB in size).
  • (warning)DO NOT RENAME OR EXTRACT THE ZIP FILE! (warning)
  • Copy it (as is) into the base folder of the USB flash drive.


Some flash drives may not work properly. During start-up, the USB flash drive might not start quickly enough, so it might not be functional within the first seconds of the startup procedure, so Yodeck cannot detect it. This case is detailed below. If that is the case with your flash drive, try a flash drive of a different make/model and find one that works.

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.
  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. If the Player finds the flash drive, 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. If you have prepared the USB flash drive correctly as described above, the verification and writing procedure should start. If you get any error messages, check that you have properly prepared the USB flash drive.
  7. At this point, 
    1. (warning)DO NOT REMOVE POWER FROM YOUR PLAYER!(warning)
    2. (warning)DO NOT REMOVE THE USB DRIVE!(warning) 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.
  9. After reboot, the Player will re-apply all retained settings in the system.
  10. The software might also need to be updated online, so make sure you do not unplug the Player to ensure everything is completed smoothly.
  11. 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.