nbelakovski / WiFiPi翻译 / 编辑






A Raspberry Pi distribution for easy setup, requiring no keyboard, monitor, mouse, and no custom image.

Just throw this image, with NO modifications, onto an SD card, and pop it into your Pi. Your Pi is now broadcasting a WiFi network called WiFiPi, password 'luggage12345'. Connect to it, at either ssh pi@wifipi.local or ssh pi@ Default password is 'raspberry'. Now you're in! Edit /boot/wifipi-wpa-supplicant.txt with your network information, or just go write some code!

This repository contains the source script to generate the distribution out of an existing Raspbian distro image.

Where to get it?

Releases tab

How to use it?

  1. Unzip the image and install it to an sd card like any other Raspberry Pi image
  2. Boot the Pi from the card. No external peripherals are necessary.
  3. Connect to WiFiPi, password is luggage12345
  4. Log into your Pi via SSH (it is located at wifipi.local if your computer supports bonjour or at, default username is "pi", default password is "raspberry".
  5. Edit /boot/wifipi-wpa-supplicant.txt to add the information of the wifi network you'd like to connect to. Optionally, edit /boot/wifipi-network.txt if you'd like to specify additional configuration parameters, like static IP address and so forth, BUT: be sure to edit /boot/wifipi-network.txt first, since AutoHotspot runs once per minute and uses whatever it finds in /boot/wifipi-wpa-supplicant.txt. If it runs while you're editing a file, your connection will get dropped.
  6. AutoHotspot will run once per minute to check that the connection is still active, and launch a hotspot if it is not. You can disable it by running sudo crontab -e and putting a # in front of the line with all the asterisk (and in front of the reboot line if you like). You can see logs from AutoHotspot in /var/log/autohotspot.log, but this will get cleared daily.


  • AutoHotspot Automatically launch a Direct Connection WiFi hotspot when no other connection is available.
  • Raspbian tweaked for maximum preformance in a headless configuration


For development instructions, see the corresponding section at https://github.com/guysoft/CustomPiOS

Code contribution would be appreciated!