• PC (Windows/Mac/Linux) with microSD card reader/writer
  
• Software for writing image to microSD card
  
• Ethernet cable with connection to internet (cable is needed during installation, when moOde is running you may switch to WIFI)
  

• USB keyboard
  
• Display connected via HDMI cable OR Raspberry Pi 7" Touch Display
  

• Software for remote terminal session
  
• Software for finding out the IP address of your Pi OR display connected via HDMI (which will show the IP address)
  

• Use the right (corresponding) version of Raspian image (operating system)! Further information on step 1.
  
• Defective/incompatible microSD card. Simply try a different microSD card if installation does not work!
  
• Insufficient power (especially on power peaks during installation). (If the lightning bold is already being displayed (sometimes) during regular usage I do not recommend to try an installation.) Possible Solutions:
  • During installation unplug everything that is not needed for installation like USB devices others than keyboard (and perhaps even DAC Hat)
    
  • Try a different power supply (especially when you are using 7" touch display) with 2500mA or 3000mA on 5V (like the official Pi power supply)
    
  • Try different cables if you have a power supply that does not have a fixed cable (yes, by far not all USB-cables are designed for power consumption higher than 1000mA or match with any power supply)
    
• Sometimes a server for downloading the necessary packages cannot be reached, because it is not available or your connection or download request timed out (can happen if your internet connection is  overloaded - happens to me at my home every sunday afternoon :-( ). In this case you have to reboot the Pi and it will continue where it stopped. (something like "failed to fetch / unable to fetch some archives"
  • Setup an SSH connection according to chapter "3. Remote alternative: establish SSH connection". Then login SSH and check out process progress as described in chapter "6. Installation & progress status"
    

• (if you are using Win 32 Disk Image Writer extract the .img-file from the download file using e.g. 7-Zip)
  
• start Etcher or Win32 Disk Image Writer
  
• select the image file
  
• select the correct destination drive letter of microSD card
  
• hit the write button, writing process will start and show you a progress bar
  
• when writing was successful on Windows 10 you have to ignore and abort the upcoming messages (they are caused by an additional Linux partition that was created on the microSD card. Windows cannot read it so it is showing those anoying messages and recommendation to format again. Hope MS will change this messy behaviour.)
  
• only "remote alternative": you HAVE TO create a file called "ssh" in the root directory of the microSD card (where a lot of other files like "config.txt" are being displayed) to ACTIVATE the necessary SSH functionality. This is a security function - reason read here. On Windows easiest way is to create a new text file, name it ssh and IMPORTANT remove the ".txt" file extension (probably you have to disable the hiding of file extensions in Windows).
  
• (on windows use eject function and) remove the microSD card from the reader and insert it into your Pi
  

• file called "ssh" is needed in root directory, otherwise you CANNOT establish a connection. If you forgot to create the file, power off, remove the microSD card from the Pi, insert it into your PC and create it as described in chapter "2. Write image".
  
• plug in the power cable into your Pi and wait for about 30 seconds
  
• find out the IP address of your Pi in your network
  • "Hardware" solution: if you are connecting a display (either via HDMI or the touch display) after the first boot of Raspian operating (in the next step), a few lines before the last statement there should be a line that starts with "My IP address is...". Either it is in a format like 192.168.0.23 (thats IP address version 4) or it is something like 2a02:810d:fc0:2650::9 (that IP address version 6). In the second case, only enter the address until the first blank! Usually there are listed multiple of those IP version 6 adresses but you must only enter ONE of them.
    
  • "Software" solution: run a network scanner program/app which shows you all IP adresses in your network. On Windows download Advanced IP Scanner (Screenshot) here and start it (it offers "run" without installation). On iOS/Android smartphone/tablet use Fing (Screenshot) from Google Play Store or Apple App Store. For Android there is an open source alternative called Port Authority (Screenshot) on F-Droid or Google Play Store. Of course you need the IP address for "Raspberry Pi" device (red markup on the screenshots).
    
• use an SSH client to connect to your Pi. On windows for example download Putty either as regular installer here or as portable app here. On iOS (iPad, iPhone) Shelly is small and easy to handle. On Android you may use ConnectBot from Google Play Store or F-Droid.
  Install/extract the application and start it. It will only display a small window with tons of setting, but you only have to fill out ONE field "Host Name (or IP address)" with the network address of your Raspberry Pi and hit the "Open" button.
  
• IMPORTANT: using SSH you don't have to worry about foreign keyboard layouts in step 4
  

• Write OS build directly to the boot SDCard? -> y (german usb keyboard: z)
  
• Do you have a backup of your boot SDCard? -> y (german usb keyboard: z)
  
• Enter Current Date (YYYY-MM-DD) -> enter date (german usb keyboard ß for -)
  
• Make corrections -> n
  
• Use a proxy server for Internet access -> n
  
• Use a WIFI instead of Ethernet? -> n
  Switching to WIFI should be done later when moOde is running.
  
• Proceed with build -> y (german usb keyboard: z)
  
• Power off the Pi -> y (german usb keyboard: z)
  
• Wait for about 10 seconds until the green LED on Pi stops blinking. Then unplug the power cable AND keyboard (its not needed anymore).
  

• choose "Configure" then "Network", click "Scan" button next to SSID field.
  
• choose your Wifi network name in the dropdown list and enter your password in "Password" field. Then hit "Apply" button on the top of the page and reboot moOde.
  
• To check if your WIFI is working correctly go to "Configure" and "Network" again.
  
• Open system menu again and it will show the additional entry "System info", it opens a popup window.
  
• Next to "WLAN0 IP" there should be a number, if it still shows "unassigned" the WIFI setup did not work.
  
• If WLAN shows an IP address you are safe to shutdown your Pi and remove the ethernet cable and power on.
  
• In case the user interface looks broken in your browser on first boot without ethernet cable but WIFI then use "Refresh" button in system menu.
  

• "Library" is showing scanned tracks based on meta file information ("tags"). You have to select an album so that tracks are displayed. You may add single tracks through the three dots button on the very right of every track or add the whole album by clicking on the cover art picture.
  
• "Browse" and "USB" is showing the file/directory view. Klick on folder names for navigation, klick on icons for adding folders and files to playlist.
  

• "Add" is adding tracks to the end of the playlist but continues playing
  
• "Play" is adding tracks to the end of the playlist and jumps to the first of the added track
  
• "Clear/Play" first empties the playlist, is then adding the tracks and starts playing the first of the added tracks.
  

(06-25-2018, 08:24 PM)Tim Curtis Wrote: Hi,

You will have to add the ssh file to the /boot directory, then ssh will be enabled after next reboot.

-Tim

(06-25-2018, 03:34 PM)Martin-Andersen Wrote: Thanks great guide, everything works.

I just forgot to add the ssh file in the root before starting the moode installation. Can I get access to the terminal again?
After boot I get a blank screen as you wrote. Can I hold down some keys to stop that behavior?

Thanks