Start WiFi setup with the power button — by device

On players that have a power button, a short press starts (or stops) the setup hotspot — so an installer can bring up the QR code on site with one tap, no tools.

The rule: short press = WiFi setup

Short press (a quick tap) → the setup hotspot toggles: if it's off it starts and the QR code appears; if it's already on, it turns off.
The player deliberately catches the power button so a short tap does not switch the box off — it opens WiFi setup instead.

There is nothing to install per box. The button behaviour is part of the player software, so it "just works" on a supported player once it is running a release that includes the feature.

By device

Raspberry Pi 5

Short press → setup hotspot toggles (QR code appears / disappears).
Press and hold for 5 seconds → the Pi 5 performs a hardware power-off. This is done by the Pi's power chip and cannot be intercepted by software — it will always cut power. Use it only when you actually want the box off.

Rule of thumb for the Pi 5 button: quick tap = WiFi setup, long 5-second hold = force off. There is nothing in between.

PC / generic x86 players

The front power button is read as a standard power key, so a short press toggles the setup hotspot just like on the Pi 5.
Caveat: some PCs/BIOSes are configured to shut the machine down on a power-button press before the app can react. If tapping the button powers the box off instead of showing the QR code, that machine's button can't be used for this — start the hotspot from manage instead (see below).

Raspberry Pi 4

The Pi 4 has no usable button for this.
Start the hotspot one of the other two ways: it comes up automatically when the box is offline, or you send the **start_hotspot** command from manage (see below). This is the normal method for Pi 4 installs.

No button? Start it from manage

Every player — with or without a button — can be told to open the hotspot remotely:

Send the device command **start_hotspot** (and **stop_hotspot** to close it). See All remote commands (reference).
This only works while the box still has some connection to manage (e.g. Ethernet, or a WiFi you're about to replace). A completely offline box will instead raise the hotspot by itself — see The setup hotspot: how it works.

Troubleshooting

Symptom	Likely cause	Do this
Tap powers the box off (PC)	BIOS/OS shuts down on power key	Use `start_hotspot` from manage
Nothing happens on a Pi 4	No button on Pi 4	Use offline auto-start or `start_hotspot`
QR never appears but box is paired & online	Silent hotspot (banner hidden so it doesn't cover content)	Press again / send `start_hotspot`; the network name & password are the same either way
Box switched off on a long press	5-second hold = hardware off (by design)	Power it back on; use a quick tap next time