How to Flash-Out Screenly to an SD card

To install or update Screenly on your Raspberry Pi 3/B/B+ or Box 0 player you will need: an SD card, an SD card reader, and the free program Etcher installed on your computer - you can download Etcher here:

If you do not have an SD card reader you can buy one here (below), or any other retail location:

This video has a quick overview of the steps involved:



1. Download and Install Etcher

2. Log in to, go to "Screens" and click the "Add Screen" button. On that page under "step one" click the button to "Download the Screenly disk image", this will download a .ZIP file with the ISO inside.  (An ISO file is a Disk Image, you will use Etcher to write or 'flash' your SD card with this disk image in the next steps).
3. Plug your SD card into the SD card reader and the reader into the computer if it isn't already. In Windows, you might see a pop-up asking you if you want to format the SD card. You should format the SD card in the FAT32 format.
4. On your computer open Etcher.
5. In Etcher there are three steps:
   a. Click Select Image - find the .ZIP or .ISO file that you downloaded in step 2, select it and continue. If you cannot find the file you downloaded: go back onto your web browser, then on your keyboard hold CTRL + J. This will open a new tab with your download history. Find the Screenly file in the list and  click "Show in folder" to see where it is.   
   b. Click Select Drive - Your SD card will show up as a disk drive on Windows, find and select it and continue. Your SD card will probably be drive D, E, F, or G. The Icon next to it should indicate that it's a USB or SD card.
  c. Click Flash! It will take a minute or so for Screenly to be flashed onto the SD card.
6. Once Etcher is done flashing the card you want to go to windows explorer, right-click on the SD card drive and select "eject",  the drive will then be safe to remove. 
7. Remove your SD card and plug it into the tiny slot on the bottom side of your Raspberry Pi motherboard. 
7. You're done! Put your player back together, plug it in and continue with the setup.  


If you are using macOS, you have two options. Either you can use a graphical interface tool like Etcher, or you can use the built-in tools. For non-expert users, we strongly recommend that you use a graphical interface tool.

If you prefer to use the command-line tools, first identify the device using df -h. With that done, simply replace rdiskX with this device.

diskutil unmount /dev/diskXsY
unzip -p /path/to/ | sudo dd bs=1m of=/dev/rdiskX

The Easy Way
If you are not a hardcore Linux user, we strongly recommend that you use the tool Etcher instead of following the instructions below.

The Hard Way

Warning: The instructions below require that you are familiar with dd and device mappings on Linux. Unless you know what you are doing, following these instructions can cause significant data loss as there are so many variables that can cause errors to be made. Don’t proceed unless you know what you are doing. You have been warned.

Below you can find a complete start-to-finish guide on how to flash out the latest Screenly Pro disk image on Linux.

Please note that your device mappings may differ.

Check the status of the SD card before we begin

$ sudo fdisk -l /dev/sdc
Disk /dev/sdc: 7948 MB, 7948206080 bytes
240 heads, 32 sectors/track, 2021 cylinders, total 15523840 sectors
Units = sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disk identifier: 0xe9142f04 Device Boot Start End Blocks Id System
/dev/sdc1 2048 15523839 7760896 b W95 FAT32

Fetch the disk image and MD5 file

$ wget
Length: 687965333 (656M) [application/zip]
Saving to: `latest-pro'
$ wget
Length: 66 [binary/octet-stream]
Saving to: `latest-pro.md5'

Verify the download

$ cat latest-pro.md5
$ mv latest-pro
$ md5sum -c latest-pro.md5 OK

Flash out the image

$ unzip -p | sudo dd bs=32M of=/dev/sdc
0+34550 records in
0+34550 records out
3947888640 bytes (3.9 GB) copied, 395.227 s, 10.0 MB/s

Verify the result

$ sudo fdisk -l /dev/sdc

Disk /dev/sdc: 7948 MB, 7948206080 bytes
245 heads, 62 sectors/track, 1021 cylinders, total 15523840 sectors
Units = sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 512 bytes
I/O size (minimum/optimal): 512 bytes / 512 bytes
Disk identifier: 0x00014d34

   Device Boot      Start         End      Blocks   Id  System
/dev/sdc1            8192      122879       57344    c  W95 FAT32 (LBA)
/dev/sdc2          122880     7710719     3793920   83  Linux

It’s important that you now eject the card and put it back in before proceeding.

Verify the file system

$ sudo fsck.vfat /dev/sdc1
dosfsck 3.0.12, 29 Oct 2011, FAT32, LFN
/dev/sdc1: 92 files, 3753/7161 clusters
$ sudo fsck.ext4 /dev/sdc2
e2fsck 1.42 (29-Nov-2011)
/dev/sdc2: clean, 82223/237568 files, 401880/948480 blocks
If you get stuck somewhere let us know at and we'll do our best to help. 
Have more questions? Submit a request


Article is closed for comments.