Install Instructions


Version Information

Version 1.0 was the version shipped with the frames at christmas 2021.

Version 2.0.0 was released June 2022. The new version allows for many improvements

  • Removed dependency on Google
  • Remove Updatable
  • Stability
  • Updated OS

Upgrade/Install instructions

  1. Grab and download the latest version below.
  2. Grab balenaEtcher if you don't already have it. Download here
  3. Open the frame and remove the micro sd card from the primary board. Reference: here
  4. Insert into a card reader. You may need to use an adapter (one provided with frame) if your card reader only supports full size cards.
  5. Open up balenaEther and choose the photoframe-image-x.x.x.img file you downloaded. (x.x.x corresponds to the version downloaded)
  6. Verify the device balenaEtcher chose to write the image to. (normally correct unless you have multiple drives connected)
    • Note: that it might say Multiple Device. This is because the single card has multiple partitions.
  7. Click Flash!
  8. Wait for it to complete. If successful continue. If not try flashing again. Depending on the reader you may want to try another usb port.
    • The end of the flashing process will verify the write. During this the drive will mount to the computer. If any windows pop up during then ignore them. It will fail the verification if you interact with them.
  9. You will need to configure the wifi as before. The wifi information in the image is for the Mason's house. To set your wifi:
    1. With the card still in the card reader open up your file manager (File Explorer/Finder)
    2. There will be a drive called boot
    3. Locate the file called wpa_supplicant.conf.example and make a copy of the file.
    4. Rename the copy of the file to wpa_supplicant.conf (Depending on your computer the extension may not show. If not and you type the extension during rename the file will become wpa_supplicant.conf.conf)
    5. Open the copied file in a basic text editor (Notepad, TextEdit)
    6. There are two edits that you need to make
      1. Change "NETWORK_NAME" to be your network name. Example "My awesome network name". This makes that line ssid="My awesome network name"
      2. Change "NETWORK_PASSWORD" to be your network password. Example "supersecretpassword". This makes that line psk="supersecretpassword"
    7. Save the file
    8. Confirm once again that the filename is what is listed above. If the editor added .txt to the end you can safely remove it.
  10. Eject the SD card and replace in the primary board.
  11. Reassemble the unit and power it up.
  12. The first startup my take a second or two to show anything.
  13. If it was successful you should see messages about sytem starting and IP information (confirming network connection) and then eventually images.
  14. If the unit does not show a local IP or never gets to a point of showing images the issue is with connecting to the network.
    • Pull the card again and see if the copied file you made disappeared. If it did then the file was named properly. If not then the name is wrong.
    • If the file disappeared then the contents were incorrect or invalid. Try again.