Set Up Instructions



The following are the instructions to set up a Raspberry Pi Smart Azan Clock with wired speakers in kiosk mode without attaching a monitor, keyboard or mouse to it ("headless setup").

  1. Get Required Hardware
    • Raspberry Pi Kit
    • Speakers

  2. Download Software & Tools

  3. Burn Raspberry Pi OS to SD Card using Etcher
  4. After Etcher writes & verifies the card it'll eject it. Remove the card reader from your computer and insert it back in. If your computer asks to format the card again click on Cancel/No. You'll now see a new drive on your computer named "Boot".
  5. Connect to your WiFi
  6. Add a new file named "wpa_supplicant.conf" to the root folder of Boot Drive with the following content. (Use your WiFi credentials for ssid and psk.)

    ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
    update_config=1
    country=US
    network={
        ssid="YOUR_WIFI_NETWORK_NAME"
        psk="YOUR_WIFI_PASSWORD"
        key_mgmt=WPA-PSK
    }

  7. Enable SSH
  8. Add an empty file named "ssh" to the root folder of Boot Drive.
  9. Insert SD Card into RPi & power it on.

  10. Connect using PuTTY
  11. Try raspberrypi or raspberrypi.local as the host name. If these don't work you'll have to find out RPi's IP address from your router manager.
  12. Change default password
  13. RPi's default username: pi
    password: raspberry
    Run passwd command and follow the instructions.
  14. Update all Raspberry Pi OS Packages to latest
  15. sudo apt-get update
    sudo apt-get upgrade
    sudo reboot

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

  18. Set up kiosk mode on initial start up
  19. cd ~/.config
    sudo mkdir -p lxsession/LXDE-pi
    cd lxsession/LXDE-pi
    sudo nano autostart
    
    Copy & paste the following content to autostart file

    @lxpanel --profile LXDE-pi
    @pcmanfm --desktop --profile LXDE-pi
    #@xscreensaver -no-splash
    @point-rpi
    @xset s off
    @xset s noblank
    @xset -dpms
    @chromium-browser --noerrdialogs --disable-session-crashed-bubble --disable-infobars --kiosk https://smartazanclock.com/
    

  20. Enable VNC and remote desktop to RPi (optional)
  21. sudo raspi-config
    Select "Interfacing Options". Enable VNC and Finish.

    You can connect to your RPi using RealVNC and see Smart Azan Clock in action. You can add a bluetooth speaker, adjust device volume and change app settings directly on the device.
  22. Reboot
  23. sudo reboot
You can now go to smartazanclock.com 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 smartazanclock.com 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.