Set Up Instructions

Headless setup instructions to run SmartAzanClock App on your RPi in kiosk mode.

  1. Get Required Hardware
    • Raspberry PI Kit
    • Speakers

  2. Download Required Software

  3. Burn Raspbian to SD Card using Etcher
  4. After Etcher writes & verifies eject the card and insert back in. If your computer asks to format the card again click on Cancel or No.
  5. Enter your WiFi information
  6. Add "wpa_supplicant.conf" file to the root folder of Boot Drive. Use your WiFi credentials for ssid and psk.
    ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev

  7. Enable SSH
  8. Add an empty file named "ssh" to the root folder of Boot Drive.
  9. Insert SD Card into RPi & plug it in.
  10. Try connecting to raspberrypi.local. If this doesn't work you'll have to find out RPi's IP address from your router manager.
  11. Change default password
  12. RPi's default account is username: pi & password: raspberry. Run passwd command and follow the instructions.

  13. Update all Raspbian Packages to latest
  14. sudo apt-get update
    sudo apt-get upgrade
    sudo reboot

  15. Update Chromium Browser to latest
  16. sudo apt-get install chromium-browser

  17. Update to the latest firmware (Kernel Version)
  18. sudo rpi-update
    sudo reboot

  19. Set up kiosk mode on initial start up
  20. Update ~/.config/lxsession/LXDE-pi/autostart file.
    @lxpanel --profile LXDE-pi
    @pcmanfm --desktop --profile LXDE-pi
    #@xscreensaver -no-splash
    @xset s off
    @xset s noblank
    @xset -dpms
    @chromium-browser --noerrdialogs --disable-session-crashed-bubble --disable-infobars --kiosk

  21. Disable Bluetooth
  22. Add following setting to /boot/config.txt. (RPi Bluetooth audio has some chronic "static" issues and because of that we recommend using wired speakers.)

  23. Enable VNC
  24. sudo raspi-config
    Select "Interfacing Options". Enable VNC and Finish.

    If you can hook up your RPi to a monitor via the HDMI port and also attach a mouse and a keyboard you can skip this step and do the rest directly on the RPi itself.
  25. Connect via VNC or directly

  26. Close warning dialogs

  27. Set Chromium as the default browser

  28. Remove unnecessary browser plugins

  29. Set as your home page

  30. Quit VNC

  31. Set Audio Output to 3.5mm headphone jack
  32. Advanced Options > Audio > Force 3.5mm headphone jack
    sudo raspi-config

  33. Increase RPi Volume so the whole house wakes up for Fajr!
  34. Set this manually to 70% or more.
  35. Remove all unnecessary software
  36. sudo apt-get remove --purge wolfram-engine realvnc-* libreoffice* geany greenfoot triggerhappy python-minecraftpi python3-thonny bluej nodered xpdf nuscratch scratch scratch2 sense-hat sonic-pi claws-mail claws-mail-i18n
    rm -rf ~/python_games
    sudo apt-get clean
    sudo apt-get autoremove

  37. Restart the device.
You can now go to on any smartphone or computer that's on the same WiFi network and update your Smart Azan Clock settings (location, azans & alarms).

You can also add as an app to your smartphone home screen using your OS default browser; Chrome on Android phones, Safari on iPhones.

Alhamdulillah wa Shukrulillah!

Your Smart Azan Clock is ready.