Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Low-cost iBeacon platform using Raspberry Pi


All components are required unless stated otherwise.


  • Raspberry Pi Zero W
  • Raspberry Pi Zero Case (Optional)
  • microUSB cable
  • 4 GB or larger microSD card
  • microSD to SD card adapter (Required unless you're able to write to a microSD card directly from your computer)
  • Computer capable of writing to an SD card
  • iPhone, iPad, or iPod touch (Any one device from the sub-list required)
    • iPhone 5s (Partial support)
    • iPhone 6 (Partial support)
    • iPhone 6 Plus (Partial support)
    • iPhone 6s
    • iPhone 6s Plus
    • iPhone SE
    • iPhone 7
    • iPhone 7 Plus
    • iPhone 8
    • iPhone 8 Plus
    • iPhone X
    • iPhone XS
    • iPhone XS Max
    • iPhone XR
    • iPad (5th generation)
    • iPad (6th generation)
    • iPad mini 2 (Partial support)
    • iPad mini 3 (Partial support)
    • iPad mini 4 (Partial support)
    • iPad Air (Partial support)
    • iPad Air 2 (Partial support)
    • 9.7-inch iPad Pro
    • 10.5-inch iPad Pro
    • 11-inch iPad Pro
    • 12.9-inch iPad Pro (1st generation)
    • 12.9-inch iPad Pro (2nd generation)
    • 12.9-inch iPad Pro (3rd generation)
    • iPod touch (6th generation) (Partial support)


The below list doesn't include the various components of the PiBeacon project itself.

  • PiBakery
  • macOS or Windows (Any one version from the sub-list required)
    • macOS Mavericks (Partial support)
    • macOS Yosemite (Partial support)
    • macOS El Captian (Partial support)
    • macOS Sierra
    • macOS High Sierra
    • macOS Mojave
    • Windows Vista (Partial support)
    • Windows 7 (Partial support)
    • Windows 8 (Partial support)
    • Windows 10 (Partial support)
  • iOS (Any one version from the sub-list required)
    • iOS 11
    • iOS 12
      Support for older versions of iOS is under development.


  1. Open PiBakery
  2. Click "Import"
  3. Navigate to "PiBakery Recipe.xml"
  4. Replace "network-name" with your Wi-Fi network name
  5. Configure Wi-Fi authentication
    • WPA and WPA 2 networks
      1. Replace "network-password" with your Wi-Fi network password
    • WEP networks
      1. Change "WPA/WPA2" to "WEP" from dropdown menu
      2. Replace "network-password" with your Wi-Fi network password
    • Open networks
      1. Change "WPA/WPA2" to "Open (no password)" from dropdown menu
  6. Replace "pibeacon" with a custom hostname (Optional)
  7. Insert SD card
  8. Click "Write"
  9. Change "Raspbian Full" to "Raspbian Lite" from dropdown menu
  10. Click "OK"
  11. Click "Start Write"
  12. When ready, eject SD card
  13. Insert SD card into Raspberry Pi
  14. Connect Raspberry Pi to power source
  15. Install iOS client app
  16. In iOS app, tap "Add Beacon"
  17. Follow in-app instructions to configure beacon
You can’t perform that action at this time.