💾 New install: flash the image

1. Download the newest release that has image parts, from Releases (PGenerator_Plus_vX.Y.Z_pi4.img.xz.001 and .002). Image releases are rare by design. Most releases are OTA-only, so grab the latest image and update from there.
2. Join the parts and flash:
   • Windows: open .001 with 7-Zip to get the .img, then flash it with Balena Etcher or Rufus.
   • macOS / Linux: cat PGenerator_Plus_*_pi4.img.xz.0* > pgen.img.xz, then flash pgen.img.xz with Raspberry Pi Imager. Imager reads .xz directly.
   • Use a microSD card or USB stick of at least 8 GB.
3. Boot the Pi and connect to it, using one of the methods below.
4. Open http://pgenerator.local (or the Pi's IP address).
5. Go to System → Software Update → Check for Updates to move to the newest OTA release.

<details> <summary><b>Connection methods (Bluetooth PAN, Wi-Fi AP, Ethernet)</b></summary>

• Bluetooth PAN: pair with the Pi, then join its PAN in Windows settings. <p align="left"> <img src="screenshots/add_bluetooth_device.png" alt="Add Bluetooth device" width="200"/> <img src="screenshots/add_device.png" alt="Confirm device addition" width="200"/> <img src="screenshots/select_bluetooth.png" alt="Select Bluetooth" width="200"/> <img src="screenshots/select_pgenerator.png" alt="Select PGenerator" width="200"/> <img src="screenshots/join_bt_pan.png" alt="Join Bluetooth PAN" width="200"/> </p>
• Wired PAN: Ethernet cable directly between your computer and the Pi.
• Wired LAN: Pi on your router or switch.
• USB: the Pi 4's USB-C port to your computer: a network as CDC-NCM (Linux, macOS, Windows 11 without a driver), rebuilt as RNDIS when the computer does not use NCM within 5 s (older Windows). The Pi is 10.10.12.1; the boot partition also appears as a drive.
• Wireless PAN: join the Pi's access point (SSID PGenerator, password PGenerator). <p align="left"><img src="screenshots/join_wifi_pan.png" alt="Join WiFi PAN" width="200"/></p>
• Wireless LAN: join your own Wi-Fi from Connectivity in the Web UI, after connecting once by one of the methods above.

</details>

🔀 Coming from the original project?

OTA updates stay within one MAJOR.MINOR family. 2.13 needs a new kernel module, so a Pi on upstream 2.12.x cannot update to the fork over the air. To switch:

1. Export your settings with Export System Settings in the Web UI.
2. Flash the latest fork image (see above).
3. Import the backup, then use Check for Updates to reach the newest 2.13.x.

From then on the Pi follows this fork's releases. The update source is usr/share/PGenerator/update-channel, and an update_repo=owner/repo line in PGenerator.conf overrides it.

⬆️ Updating

• Web UI: System → Software Update → Check for Updates → Install Update. The dialog shows the release notes and download progress, then restarts the service. The release dropdown also lets you reinstall the current release or roll back to an earlier one.

• SSH (root / PGenerator!!$):

  /usr/sbin/pgenerator-update check   # is there something newer?
  /usr/sbin/pgenerator-update apply   # install it
  

---