Everything on the main page in short form, spelled out in full detail here, including the parts most people will not need.
Unlike the sealed Pi appliance, this trial runs on unknown, unfamiliar hardware; so DSD/DoP support and tuning depend on what you plug in.
the English kiosk image (a .img.gz file) (Google Drive link, above).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 section 4).
The downloaded .gz file is about 960 MB. Once written, the stick holds only the boot system plus a small settings area (your player/network settings, favorites, saved playlists, SSH host key and the trial countdown live here, and survive a reboot): there is no large persistent partition any more, the OS itself now runs from RAM.
.img.gz (Etcher decompresses it automatically while writing).dd: for advanced Linux/Mac usersdd irreversibly overwrites the target device. If you specify the wrong device, you will lose data. Always double-check the device name before pressing Enter.(dd is not available on Windows; Etcher is the only recommended path there.)
Booting from the stick does not start the system installed on the machine (for example Windows). The kiosk runs from the stick and from RAM, and keeps its settings only in a small settings area on the stick; the drives you choose in the music selector are mounted read-only. During playback the quiet profile only puts the drives connected to the machine, internal and external USB, into a low-power state (see 5.2). To return to your usual system, shut the machine down, remove the stick and start it normally.
If the Mac doesn't offer the USB as a boot option: on Intel Macs, the Startup Security Utility may be set to "Full Security", which blocks external boot. Restart holding ⌘+R to enter Recovery, then select "No Security" or "Medium Security" and enable "Allow booting from external media".
If Windows won't boot the USB: you may need to disable Secure Boot in the BIOS/UEFI, or enable Legacy/CSM or "boot from removable media". A UEFI BIOS is recommended over legacy BIOS for the smoothest boot.
The machine boots straight into the music selector, with no login; you simply connect to it over SSH. You never see a command line, terminal or login prompt on the machine's own screen; if you connect a monitor anyway, it stays blank. From your own device, open an SSH app and connect to kiosk@bpplay-kiosk-en-XXXX.local (XXXX the last four hex digits of the MAC address): this works even without a router or DHCP, straight over a single Ethernet cable between just the two machines. If .local names don't resolve on your network, note the machine's IP address instead (shown briefly on screen right after boot, before it would otherwise show a login prompt) and connect to kiosk@ that address. When the SSH app asks for a password, it is 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. The music selector screen then appears; nothing else needs to be typed.
Once connected over SSH, the music selector browser appears straight away; no manual installer or setup command is needed. The start screen lets you pick from the connected drives and mountpoints; if your music is on a NAS, the list includes a "Mount network share (NFS/SMB)..." line, where you just enter the address.
During playback:
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. 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 shows the track's album, artist and title, derived from the folder and file name where this can be recognized.
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 half a minute on the x86_64 kiosk. 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. The playback core itself is chosen by the boot-time measurement (see Boot-time measurement).
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. The report also shows whether the kernel command line contains isolcpus and nosmt; when nosmt is present, the switched-off hyperthreading siblings appear as offline cores, which is then the expected state and gives no warning.
Press m at any time to open the drive selector.
192.168.1.10:/music for NFS, //192.168.1.10/music for SMB). The type is recognized from the form of the address. The share must already be set up on the NAS or the other machine: the music selector only mounts an existing, reachable share, read-only. 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 (for example the machine's built-in sound card and an external USB DAC), the music selector offers a choice at start: Up and Down arrows, Enter. If there is only one output, this step is skipped. The cursor starts on the first device that does not look like a built-in sound card (such as HDA Intel), so that pressing only Enter does not pick the built-in output by accident. If you are unsure, pick the one that shows a brand name, not the built-in sound card. The selected output is remembered; the o key opens the selection again.
n key clears the selection. Enter on a track does nothing, on purpose: only Space selects, so a selection cannot be undone by accident.p key loads the selection into memory and starts playback when loading is complete. Loading speed depends on the drive and, for a NAS, on the network.q stops the whole run and ends the playlist.The bptune tuning layer runs automatically at boot: CPU governor set to "performance", Turbo Boost/Precision Boost disabled.
Kernel-level CPU-core isolation is active in this edition: the g machine survey on the trial image reports isolcpus is present in the kernel command line: yes. The boot-time measurement then chooses which isolated core plays the music.
Lockdown: no terminal emulator is installed in the system at all, the other virtual consoles (Ctrl+Alt+F2, etc.) are disabled, and the login shell IS the music browser; if it ever crashes, it just restarts, it never falls back to a raw command line.
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. Connected drives: during playback the hard disks and SATA SSDs connected to the machine, internal and external USB, are put into standby, and internal NVMe drives are put into their deepest safe low-power state, but only if the drive supports more than one power state; otherwise they are left as they are. Any later access, such as browsing to the next album, wakes them up automatically. The boot stick is left out. Only the power state changes; nothing is written to the drives. 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 card is kept awake instead; that does not apply here.
Stopping playback and the local keyboard: during playback the keyboard attached to the machine does not work (this is part of the quiet profile: the login service on the machine'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).
At a clean shutdown the stick's settings area saves only what is on a fixed list, and restores it at the next start: the music selector's settings (including favorites, saved playlists and the selected output), the SSH host key, the trial state, the network connections, the DAC mixer state, and the tuning and machine-survey results; the search index is stored there as well. Nothing else is saved. Shut the machine down with q at the top level of the music selector, and do not pull the stick or the power while it runs.
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).
bpplay is a command-line, bit-perfect audio file player for Linux and macOS. It has no graphical interface, no volume control and no equalizer, on purpose. Its goal is one thing: to deliver the contents of the music file unchanged, by the shortest path with the fewest conversion steps, to the DAC. In this edition you never start it yourself: the music selector runs it in the background for the tracks you select.
Whenever possible it plays in integer mode: the integers stored in the file reach the sound card without a bit shift or conversion. When that is not possible (for example the source is in float format, or the DAC does not support the bit depth of the source) the program says so clearly. It never silently hides a format deviation, and if a DAC does not return exactly the requested sample rate, it retries instead of quietly accepting a wrong rate.
DSD: bpplay sends DSD directly (native DSD) when the DAC supports it, and otherwise packs it into PCM frames (DoP). Which of the two works depends on the DAC chip and the DAC design, not on the computer; the machine survey and DAC diagnostics (4.4) show what your DAC advertises.
bptune is a system-tuning tool that sets Linux kernel and hardware options for low-latency, glitch-free playback and handles background services that would interfere with it (see 5 and 5.2). On the kiosk image it is already configured; there is nothing for you to do with it.
Articles on medium.com about the development of the software and the workings of computer audio systems:
This is a time-limited trial, valid for 15 days from your first real boot. The countdown is tied to the USB stick itself, not the machine you boot it on; so if you try it on several machines, the remaining time carries over.
A new image is a new trial: if the image is newer than the stored start, the 15 days count from the image. An image built more than 90 days before it is first started will not start. The music selector shows Trial: N days left on the information line below its header.
q at the top level).| Symptom | Solution |
|---|---|
| Nothing happens, blank/black screen | Wait about 30 seconds; first boot can take a bit longer. If still blank, re-write the stick. |
| Can't connect via SSH / don't know the IP | Check the machine has a wired Ethernet cable plugged in (Wi-Fi is disabled by design). Try ssh kiosk@bpplay-kiosk-en-XXXX.local first (XXXX the last four hex digits of the MAC address); this works even without a router/DHCP. If .local names don't resolve, temporarily connect a monitor to read the IP address shown on screen right after boot. Give it enough time: especially after a fresh write, the first boot can take a minute or two. Check your router's own list of connected devices instead of relying only on .local names, which some routers or VLANs block. Make sure you are on the same network as the machine: a laptop on a guest Wi-Fi may not see a machine wired to the main network. |
| "REMOTE HOST IDENTIFICATION HAS CHANGED" warning | Expected if you are connecting to a different physical stick, or re-flashed your own stick with a new image; each stick has its own SSH identity. In a terminal on your own device (not the stick), run ssh-keygen -R bpplay-kiosk-en-XXXX.local to clear the old one, then reconnect. On mobile SSH apps, look for a "forget host" option in the app's settings instead. |
| I can't see my music | Open the drive selector with m and choose the correct drive. |
| No sound during playback | Check the DAC/sound card is connected; the m key or selecting a different drive may help. |
| Playback seems unusually quiet | bpplay intentionally never touches any volume control (always bit-perfect); if the DAC's own firmware-level volume was previously set low by other software, that setting persists under bpplay too. Check your OS's audio mixer and set the DAC's own volume to maximum (0 dB). Currently, XMOS and Amanero USB interfaces are considered supported in this regard; other, more general-purpose USB audio interface chips may have a software volume control, and can be affected. Known general-purpose chip families worth checking in advance (not tested by us; the risk is inferred from the design pattern, not confirmed case by case): C-Media CM6631A / CM6632A and the consumer CM106 / CM108 / CM119 family, Savitech SA9018 / SA9023 / SA9027 / SA9227 / SA9228, Texas Instruments / Burr-Brown PCM2704 / PCM2706 / PCM2707, Tenor TE7022 / TE8802. The more a DAC resembles a general-purpose USB sound card (playback plus microphone, headset support), the more likely it has a software volume control. |
| Can't find my network share | Check same network as the NAS, and the address format (NFS: server:/path, SMB: //server/share). Network shares are mounted as a guest: a share that requires a password is not supported, and SMB shares are connected with SMB version 3.0. |
| Mac won't offer USB boot | See the Startup Security Utility note in section 3. |
| Windows won't offer USB boot | See the Secure Boot / Legacy-CSM note in section 3. |
| Machine shuts down after a short message | The 15-day trial has expired; contact whoever gave you the stick. |
If anything doesn't work as described, please send: which machine you tried it on (Mac/Windows, model), the exact error message (if any), and what you were doing when it happened. You can also ask the experimental bpplay chat assistant, which is based on more than 100 bpplay/bptune documents and links (a Google sign-in is required): open the chat.
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 stick (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 stick, including possible damage to connected audio equipment (DAC, amplifier, speakers), loss of data, or any damage resulting from use other than the intended purpose.
All rights to the software are reserved; copying, reverse engineering or passing it to third parties may only take place with the prior written permission of the developer.
Happy listening!