The full end-user edition of the manual, kept up to date here on the page.
The appliance is validated exclusively on Raspberry Pi 4 (CM4 module in the case of Holo Red) and Pi 5, with at least 4 GB RAM. Earlier Pi models, and 2 GB boards, are not tested, not guaranteed.
This end-user edition is derived from the full v2.2 manual of the bpplay/bptune appliance edition: a condensed version that describes only what you need to know for everyday use of the device. The installation, developer and administrator chapters are deliberately omitted.
The device boots straight into the music selector, with no login; you simply connect to it over SSH (see 3.1.1). You never see a command line, terminal or login prompt during use; a few keys are enough for navigation: arrow keys, Enter, Space, Esc.
bpplay is a command-line, bit-perfect audio file player application for Linux and macOS. It has no graphical interface, no volume control, no equalizer, deliberately. Its goal is one single thing: to deliver the contents of the music file unchanged, via the shortest possible path with the fewest conversion steps, to the DAC (digital-to-analog converter).
Whenever possible, the program plays in so-called "integer mode", which means the integers stored in the file (integer samples) reach the sound card without a single bit shift or conversion. When this is not possible (for example the source is in float format, or the DAC does not support the exact bit depth of the source), the program always states this clearly; it never stays silent about being forced into a compromise.
In the appliance edition the end user never launches this program directly; instead, the zenevalaszto.py Python script invokes it in the background for the selected track(s) (see Chapter 3).
Supported file formats: WAV, FLAC, ALAC (M4A), AIFF/AIFC, DSD (DSF/DFF, natively and via DoP), and SACD ISO (the disc's stereo layer, DST-compressed or uncompressed; see 3.4).
This is the most important design principle of bpplay. If, for any reason, the program cannot achieve exactly the sample rate, bit depth or format the file requires, it:
DSD (Direct Stream Digital) is a high-resolution audio format used by SACDs and some downloadable/streamed releases. Many players repackage DSD data into PCM frames (DoP, DSD over PCM) before sending it to the DAC. bpplay can send DSD data directly, without repackaging, if the DAC supports it; this is called native DSD playback.
bptune is a standalone system-tuning tool that optimizes Linux kernel and hardware settings for low-latency, glitch-free audio playback, and also handles background services that would interfere with playback.
In the appliance edition, the factory installer has already configured bptune; as an end user, there is nothing for you to do with it.
This device is issued as a trial unit: it can be used for 15 days from the first time you actually power it on, not from whenever the SD card was written. The trial period is a flat 15 days with no extension.
The music selector shows Trial: N days left on the information line below its header.
After the trial period expires, the device shuts down automatically and completely at power-on; the music selector never appears, only a brief message explains the reason for the shutdown. This restriction cannot be bypassed by setting the system clock back.
This manual assumes a Raspberry Pi 4 or Pi 5 running Raspberry Pi OS (64-bit, Debian-based). Operation as described is not guaranteed on earlier Pi models.
zenevalaszto.py also shows the estimated memory requirement of the selected list at startup, which can serve as a guide.The downloaded .img.gz file is a complete disk image, not an ordinary file to copy onto the card. If you simply copy it, the Pi will not boot. The image must be written to the card with a dedicated tool; this erases everything on the card.
You need: a microSD card of at least 8 GB, good quality (Class 10 / A1 or better), and a card reader; Balena Etcher (free, identical on Mac and Windows: etcher.balena.io); the downloaded .img.gz file (no need to unpack it).
.img.gz.Check: after a successful write the card shows a small volume called bootfs containing config.txt and cmdline.txt. If the card looks empty, or contains only an .img.gz file, the image was not written: repeat the procedure.
Alternative: Raspberry Pi Imager can be used as well ("Choose OS" → "Use custom"). If it offers "OS customization" settings, choose No: the device is preconfigured.
No technical knowledge is required for use; which is exactly why the appliance (kiosk) mode does not offer administrator privileges.
Connect the Raspberry Pi to its power supply (and if you have a separate DAC, connect it to the Pi's USB port as well). It is recommended to connect the DAC via USB 2.0 rather than USB 3.0; these are usually the two outermost connectors on the back panel. Switch the DAC on first, then the RPi. The device starts by itself.
No monitor or keyboard is needed for use: the music selector does not appear on a screen attached to the device; it is reached over an SSH connection from your own tablet, phone or computer. If a monitor happens to be connected to the Pi, its screen goes dark shortly after boot and stays off for the rest of the session; this is deliberate, not a fault, it is not stuck or frozen, it is simply switched off.
After powering on, wait about half to one minute, then establish the SSH connection to the device (see 3.1.1) and enter the password if prompted; the music selector screen then appears, with no further commands to type.
If instead you see a brief message that the device can no longer be used, followed by the machine switching itself off: the trial period has expired (see 1.5). Contact the person you received the device from.
What survives a reboot: your favorites, saved playlists and a few settings are saved automatically to the device's own storage and survive a reboot. Not kept: the currently selected (but not yet played) tracks, and the last folder you had open.
No technical knowledge is needed for this either; just a simple connection with an app, the same way as with any other app. You get the device's IP address or network name from the person you received the device from. Kiosk machines are typically reachable at kiosk@bpplay-kiosk-en-XXXX.local (hu instead of en for the Hungarian image, XXXX the last four hex digits of the MAC address) or kiosk@IP-address. The usual password, should it be needed: bitperfectsound. Both the user name and the password use only characters that sit in the same place, without Shift, on the common keyboard layouts (QWERTY, QWERTZ, AZERTY), so the login works even if your computer's layout differs from what you're used to.
Figure 1: Connecting via SSH from a macOS terminal.
ssh command.Out of the box the device connects to your network over wired Ethernet; no Wi-Fi network is set up on the image. If no Ethernet cable is connected, the device will not get an IP address and no finder tool will locate it. If kiosk@bpplay-kiosk-<lang>-XXXX.local is not reachable, check the following, in order:
.local resolution), which can be blocked on some routers or VLANs.If you have just connected a USB drive (flash drive, external HDD/SSD) with music to the device, you can reopen the storage selector on the screen at any time with the m key:
Enter.192.168.1.10:/zene for NFS, //192.168.1.10/zene for SMB). The music selector automatically recognizes the type from the form of the address. The share itself must be set up in advance on the NAS or the other machine; that is not the job of bpplay/the music selector, which only mounts an already existing, reachable share. Network shares are mounted read-only, as a guest: no user name or password is asked. A share that requires a password is not supported; enable guest (anonymous) read access for the music folder on the NAS. SMB shares are connected with SMB version 3.0, so a NAS that offers only SMB 1 or 2 cannot be mounted. Enter the share as //server/share.If several audio outputs are connected to the device (for example the Pi's built-in output AND an external USB DAC at the same time), it offers a choice at startup: Up/Down arrows, Enter. If there is only one output, it automatically skips this step too.
The selector's cursor cannot land automatically on a built-in (onboard/HDA-type) sound card if an identifiable external DAC is also present in the list; so you cannot pick the wrong output even by accident.
Enter opens the track list of a given album, Esc takes you back.Space key. The selection of any track can be removed with the n key.p starts playback of the playlist, loading the tracks into memory one by one. Playback starts after the loading completes.If the assembled playlist contains files with different sample rates, bpplay groups the tracks with identical sample rates into one playlist for the sake of gapless playback. When the next part of the original playlist, with a different sample rate, starts playing, a short pause of one or two seconds will be audible. This is not an error; the switchover simply takes this long. To avoid clicks, the bpplay software mutes the output for a few tenths of a second.
SACD ISO playback: opening a folder that contains an SACD disc image (.iso) is recognized automatically; the disc's stereo layer tracks appear as ordinary entries in the track list, selectable and playable the same way as any other track. Only the stereo layer is supported (DST-compressed or uncompressed); an uncompressed multichannel area cannot be played, and the music selector shows a clear message about this.
During playback a second status line also appears, showing the track's album, artist and title, derived from the folder and file name where this can be recognized.
| Key | Function |
|---|---|
| ↑/↓ | Navigation |
| Enter | Enter a subfolder; on a track row it deliberately does NOTHING (so it cannot accidentally undo a selection made with Space) |
| Esc | Back to the previous (parent) menu item/folder |
| Space | Select a track (in track view), or select all tracks of an entire album at once (in album view) |
| a | Select all (under the currently open folder, recursively) |
| n | Clear selection |
| r | Toggle repeat mode; when on, the playlist automatically restarts from the beginning after it finishes |
| s | Save the current selection as a playlist (asks for a name) |
| l | Load a previously saved playlist |
| o | Manually re-select the audio output (DAC) during playback; complements (does not replace) the automatic re-check before each playback |
| / | Search all drives at once (global search; every word must appear in the name) |
| m | Switch drive/storage (x there: exclude a mounted drive from, or include it in, search and indexing) |
| c | CPU isolation mode (A, B0, C0) |
| u | Full Pure on or off |
| g | Machine survey and DAC diagnostics (report) |
| i | Import a playlist (.m3u, .m3u8) |
| p | Start playback in the selected order |
| q | Quit without playing (the screen then restarts automatically, it does not stay "out"); in kiosk mode, at the top level it shuts the device down completely instead |
During playback: the table above applies to the browsing/selection screen. Once playback starts, different keys take over, note that Space and n mean something different here than while browsing.
| Key | Function |
|---|---|
| n | Next track |
| b | Previous track |
| Space | Pause / resume |
| f (or *) | Add the currently playing track to the Favorites playlist; reachable again later via l (load a saved playlist) on the browsing screen, under the name "Favorites" |
| q | Stop playback, return to browsing |
m, 3.2) and choose the correct drive.Failed to open device: 'sdcard'): the card holds no bootable system. The image was not written or the card is faulty; write it again as in 2.1, or try another card.alsamixer or amixer), and set the DAC's own volume control to maximum (0 dB).This phenomenon is not a random quirk of any particular chip vendor, but a design choice. Reference-grade devices intended purely as an audiophile digital-to-analog bridge (XMOS, Amanero) typically deliberately omit any software volume control, while general-purpose USB audio bridge chips aimed at playback and recording, or at the consumer sound card/headset market, often do include one by default.
Rule of thumb: the more a DAC/interface resembles a general-purpose USB sound card (playback plus microphone, headset compatibility), the more likely it is to have a software-adjustable volume control; the more it resembles a purely audiophile, playback-only bridge, the less likely.
Full Pure is an optional mode of the kiosk editions (x86_64 kiosk and Raspberry Pi). With it switched on, bpplay first loads the whole selection into RAM (for a playlist with mixed sample rates, the whole segment), then switches the network interface off at link level, and only then starts playing. The SSH and NetworkManager services keep running, but the link itself is down, so the machine is cut off from the network while the music plays. In our hardware checks the link LED goes dark on the x86_64 kiosk, and on the Raspberry Pi the Ethernet RJ45 LEDs go dark.
When does the network come back? The network comes back when playback ends; the connection is usually available again within about a minute on the Raspberry Pi. A safety timer, set to the playback length plus 60 seconds, is only a backup in case bpplay is killed, so that the machine does not stay cut off.
Limits:
u key in the music selector. It is off by default, and the setting is remembered.Isolation of the playback core is the same in every mode. The mode, set with the c key in the music selector, decides which other cores stay awake at all times (a power-management latency of 0 µs):
A change takes effect when the next playback starts, and does not affect playback already running. On a machine with only two active cores, C0 and A are equivalent.
Drive selector. The m key opens the drive selector. It lists mounted drives, drives that are plugged in but not yet mounted, and network shares (NFS or SMB, mounted read-only); the five most recent shares are remembered. Local drives are mounted read-only. Choosing a drive that is already mounted asks The drive is already mounted. Check for changes? (y/N); answering y re-indexes it.
Global search. The / key searches all drives at once. Every word you type must appear in the name, regardless of accents and capitals. Enter opens the folder of the result, with the cursor on the file.
Index. The search index is stored and restored, so search is ready soon after start. Hidden files and macOS ._ files are left out. While a drive is being indexed, playback waits for the first pass to finish, and the status line shows the progress.
Excluding a drive. In the drive selector, the x key excludes a mounted drive from search and indexing: it is marked (excluded from search), stays in the selector, and can still be browsed and played. The same key switches it back.
Press g in the browser for the machine survey and optimization report: machine and kernel, motherboard and BIOS, the isolated core and the CPU isolation mode, power management and scheduling, memory, the quiet profile and, where present, the Intel management engine. It is followed by DAC diagnostics: the formats the DAC advertises, the format actually used during playback, and the mixer and mute state. A short summary is shown at the first start.
Validated exclusively on Raspberry Pi 4 (CM4 module in the case of Holo Red) and Pi 5, with at least 4 GB RAM. Not tested, not guaranteed on earlier Pi models (Pi 3 and older) or on 2 GB boards.
The appliance edition boots from a microSD card. Use a good-quality card of at least 8 GB; counterfeit or worn cards are a frequent cause of boot problems.
| Device | Chip/interface | PCM | Native DSD | DoP |
|---|---|---|---|---|
| Gustard USB Audio 2.0 | (direct USB DAC) | Yes | Yes | Yes |
| TT-DAC-2026 / TT-DAC-NV | Amanero Combo 384 and 768 | Yes | Yes | Yes |
| Audio-GD DDC → Gustard (I2S) | Amanero Combo384 | Yes | No: due to the 384 kHz sample-rate ceiling, DSD256 is ruled out at the hardware level both natively and via DoP | No: the chip's DoP detector only recognizes 24-bit frames at firmware level; the 32-bit DoP attempt produced audible noise with both byte orders, and the display showed PCM instead of DSD |
bpplay's design goal is for sound to travel from the file's loading into memory to the DAC through the fewest, best-documented steps possible. When an integer source meets an integer DAC format, this means zero arithmetic conversion.
The phrase "the sound driver performs the last step" in the signal-path messages refers to the audio subsystem of the underlying operating system (ALSA on Linux); a platform-independent, precise wording.
bptune measures the CPU cores at boot and chooses the playback core.
When the quiet profile is on, the following background services are stopped for playback: cron, avahi, rpcbind, polkit, udisks2, the periodic maintenance timers, the udev control sockets, the user session manager, and Wi-Fi supplicant services when no Wi-Fi connection is active. These are never stopped: journald, ssh, NetworkManager, dbus and logind. If any of them is not running after the stop, everything is restored at once. The profile is switched off again when playback ends. During playback, the system spins down the hard disks connected to the machine, including external USB drives, because the music is already in memory. Nothing is written to the drive. It spins up again the next time it is accessed, which can take a few seconds. On the Raspberry Pi the SD or MMC card is kept awake during playback instead of sleeping.
Stopping playback and the local keyboard: during playback the keyboard attached to the device does not work (this is part of the quiet profile: the login service on the device's own screen is stopped). In normal mode (Full Pure off) playback can be stopped over SSH (with the q key of the player). In Full Pure mode playback cannot be stopped by anything: the list plays to the end, and the safety timer returns the network after the list length plus 60 seconds.
bpplay is released in Hungarian (HU) and English (EN) editions. The language is fixed in the image: it sets the texts of the music selector and of bptune, the default music folder (Zenék in the HU edition, Music in the EN edition) and the time zone (Europe/Budapest in HU, UTC in EN). On the desktop edition the keyboard layout follows the language (hu or us).
Articles on medium.com about the development of the software and the workings of computer audio systems:
RC21
u key): the network is switched off at link level while the music plays./ key, with a stored index; playback starts only after the first indexing pass.g machine survey: report texts, the CPU isolation mode screen, a short summary at the first start, the Intel management engine runtime state, USB controllers.._ files are not indexed.q or Esc.RC22
a and n; an SSH banner on the Raspberry Pi; the HU desktop edition gets the Hungarian keyboard layout.g report has a DAC section: the formats the DAC advertises, the format used during playback, and the mixer and mute state.R key is gone from the drive selector, and an already mounted drive asks whether to check for changes.x key excludes a drive from search and indexing only; the drive stays in the selector with the mark (excluded from search), and the same key switches it back.The bpplay and bptune software, as well as the music selector serving this device (zenevalaszto.py) is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability or fitness for a particular purpose.
The developer accepts no liability for direct or indirect damages arising from the use, malfunction or failure of the software or the device, including possible damage to connected audio equipment (DAC, amplifier, speakers), loss of data, or any damage resulting from use other than the intended purpose.
This manual strives to describe the most accurate, current state possible, but the developer does not guarantee the completeness or error-freeness of its contents, and reserves the right to update it without prior notice. The device and the manual are made exclusively for the end-user music-listening purpose described herein; any other use is at your own risk.
All rights to the software and the device are reserved; copying, reverse engineering or passing them to third parties may only take place with the prior written permission of the developer.
Happy listening!