Jump to sample rate, Audio HAT and Pi 4 jack, network, administrator access or status and diagnostics.
Open System Maintenance on port 8003
In VinylRest Discovery, choose System Maintenance, or open http://PI-ADDRESS:8003/. This Configurator is independent of Live and its license. It remains available before activation, when audio is stopped and when the audio service cannot open a device.
| Where | Configure | Effect |
|---|---|---|
| Configurator · 8003 | Preferred sample rate | Save and restart audio briefly restarts the active Live service, not the Pi. |
| Configurator · 8003 | Audio HAT boot-driver policy | Preserves the Live route; an explicit appliance reboot may be required. |
| Live Settings · 8001 | Input/output devices and stereo pairs | Reopens the audio session and invalidates route-specific calibration; the WebApp remains available. |
Preferred sample rate

Begin at 48 kHz. The saved rate is a ceiling: Live negotiates a common native rate supported by the selected input and output. Check the actual running format in the Live status bar. Input and output bit depths are negotiated independently: 24-bit capture can feed a 16-bit output, and 16-bit-only interfaces remain usable.
| Hardware / rate | Available rate choices | Automatic DeClick policy |
|---|---|---|
| Pi 4 Model B | 48 kHz only | Ordinary clicks only; other families remain unavailable. |
| Pi 5 · 44.1/48 kHz | 44.1, 48, 88.2 and 96 kHz | All five families at these lower rates. |
| Pi 5 · 88.2/96 kHz | Subject to a common native device rate | Ordinary clicks only to preserve processing headroom. |
DeCrackle, NR, conditioning, grading and Auto remain available. The policy follows the negotiated rate, not just the saved ceiling. Pi 5 Custom family selections are described in Live Settings; they do not guarantee high-rate real-time performance.
Choose Preferred sample rate, then Save and restart audio and confirm the interruption. Live and its browser connection restart; the Configurator stays available and the Pi itself does not reboot. An administratively stopped Live service stays stopped. If a restart fails after saving, the preference may be saved without being applied: check the result and diagnostics.
When moving a card from Pi 5 to Pi 4, explicitly save 48 kHz. Merely opening or refreshing this page does not rewrite a saved preference or interrupt audio.
Audio HAT: boot driver, not playback routing

Audio HAT driver policy prepares an I2S board's operating-system driver. It does not choose the input or output used by Live. After the driver is ready, choose the resulting device and connector pair in Live Settings.
- Automatic (identify a supported HAT EEPROM)
- Uses an exact recognized HAT identity. An unknown board is not guessed from a similar chip or name.
- No Audio HAT (USB / Pi 4 jack)
- Use the no-HAT policy for a USB setup or the Pi 4 analogue jack. Existing owner-managed overlay conflicts still require explicit resolution.
- Exact manual model
- Choose the actual board when automatic detection is insufficient. The driver must exist in the installed OS; a generic I2S option requires compatible wiring.
- Fit or rewire hardware only with the Pi powered off, following its manufacturer's instructions.
- Open the Configurator and review the detected HAT, available jack and driver-policy message.
- Select Automatic, No Audio HAT or the exact manual model, then choose Save hardware policy and confirm.
- If the result says Reboot required, finish listening, download any needed diagnostics and choose Reboot appliance explicitly. Saving hardware policy does not automatically stop Live or reboot the Pi.
- After startup, rediscover the Pi, check hardware status and choose its input/output endpoints in Live Settings.
Package b1-28 offers 37 choices: Automatic, no HAT and 35 manual driver profiles, with product variants grouped where they share a driver. The current b1-29 image includes the expanded choices; earlier b1-27 images required the signed b1-28 update. The screenshot shows the installed b1-28 application, not a newly flashed image.
The catalogue includes HiFiBerry, Allo, IQaudio/Raspberry Pi, JustBoom, selected AudioInjector, Audiophonics, Orchard ApplePi and documented DAC aliases. Inclusion means a supported driver-policy choice, not physical qualification of every board, Pi revision or format. Unknown hardware, absent drivers and conflicting owner overlays are reported rather than silently overwritten.
Pi 4 onboard analogue output
Without an active Audio HAT, the appliance enables the Pi 4 jack and prepares its verified ALSA playback level at +4 dB. This hardware gain is downstream of Live's software meters: it is not included in their output reading and does not prove the analogue output is free of clipping. USB and HAT mixers do not receive that boost.
A configured HAT normally disables the Pi 4 jack. Pi 5 has no onboard analogue jack, and HDMI audio remains disabled in the standard appliance configuration. Do not assume a playback-only device also provides a capture input.
Identity, region and Wi-Fi
Set Appliance name, timezone region/timezone and the Wi-Fi country where you use the Pi, then select Save identity. After a hostname or network change, use Discovery again if the old address stops working.
Select Scan networks to list nearby Wi-Fi networks, or enter an SSID manually. Provide the password, enable Hidden network if needed and choose Connect Wi-Fi. Leave the password empty only for an open network or one whose password is already saved. Ethernet provides a useful fallback while changing Wi-Fi.
For startup without Ethernet, use the freshly written card's vinylrest-wifi.toml file before its first boot. The Configurator displays the actual connected SSID, not the boot importer's internal connection label.
Administrator access

The SSH account is vinylrest, with elevated maintenance access. A clean public image has no shared initial SSH password. Use Update password to set your own, or paste an OpenSSH public key and choose Add SSH key. Existing keys are retained; never paste a private key. Keep administrator credentials under your control.
System status and maintenance

Refresh status reads current timezone, Wi-Fi state, SSH-key count, detected cards and preferred rate without applying changes. The preferred-rate summary is not a measurement of both active endpoint depths. Live's footer shows the running route, rate and input/processing depth; playback depth may differ. Use diagnostics and native audio-format logs when you need the details of both endpoints.
Reboot appliance interrupts audio and restarts the Pi. Download diagnostics first if a fault is present, then use Discovery to reconnect. Software updates, read-only reports and factory configuration reset are explained in Updates and recovery.