Skip to content

Repository files navigation

🐧 Pi Studio

A low-latency audio-production Linux distribution for the Orange Pi 5B (Rockchip RK3588). Free, open, fully offline, and privacy-first. Flagship: Sonic Pi live-coding music.

noisy-but-honest — we tell you what works, what doesn't, and why.


What it is

Pi Studio is a music-production OS for the Orange Pi 5B (Rockchip RK3588) — around $250 for the 16 GB board. Flash this image and you've got a real studio: a kernel re-tuned for real-time audio, a curated stack of open-source music tools, hardware-accelerated 4K video, and a desktop built for making sound — not phoning home. Based on Ubuntu 24.04 (Noble), arm64.

Highlights

  • 🎚️ Verified low-latency kernel — hit a key, hear it now. Full preemption + 1000 Hz tick. Measured on hardware: ~115 µs worst-case scheduling latency under full 8-core load, 0 xruns at a 1.33 ms buffer (~82× lower worst-case jitter than a stock desktop kernel — same chip, config alone).
  • 🎵 Sonic Pi 5.0.0-beta4 — the newest upstream release — front and center, with a custom PiStudioMode theme, game-controller input, and MIDI-clock master/slave so it drives (or follows) your gear.
  • 🖥️ 4K@120 display (custom-patched VOP2 kernel) — validated on hardware, visually clean. Hardware video decode in media players (mpv/VLC via rkmpp); ⚠️ browser video is software-decoded — a GL-driver limit on this SoC, see KNOWN-ISSUES.
  • 🎹 A full open-source studio — Ardour, Hydrogen, Rosegarden, Surge XT, Yoshimi, amsynth, qsynth, Calf plugins, VMPK, qpwgraph, and more, on PipeWire with realtime priority.
  • 🔌 Class-compliant USB audio interfaces work out of the box (no autosuspend dropouts).
  • 🔒 Offline & private — no telemetry, no phone-home, snap-free, works with no internet.
  • 🎧 WiiM control, built in — drive your WiiM streamer from the desktop, out of the box. Rare in a Linux distro; standard here.
  • 📺 DRM streaming video at 720p — Chromium plays Prime Video, Disney+, Spotify, and DRM YouTube; enable Widevine with the guide that ships on the desktop.

What you'll hear

  • Tighter feel. Less delay between hitting a key and the sound — monitoring and live coding feel immediate, not laggy.
  • Clean under load. Render a busy live_loop while the system works — no clicks, no dropouts.
  • Smaller buffers. Push the buffer down to the lowest your interface allows, and stay glitch-free.

It's not just a label: the kernel is built from a re-tuned config (verified CONFIG_PREEMPT=y, CONFIG_HZ=1000), not a stock kernel wearing a new name. We traded throughput you'll never miss for timing you'll definitely hear.

Hardware

  • Orange Pi 5B (Rockchip RK3588, 8-core, Mali-G610, arm64) — the primary target.
  • The audio + kernel work applies to other RK3588 boards too; the 5B is what's tested and tuned.

Moving to eMMC

Running from SD? docs/install-to-emmc.md — one command clones your set-up system onto the onboard eMMC.

Adding storage, and where to plug in your interface

EXTERNAL-STORAGE.md — put the audio interface on USB 2.0 (class-compliant interfaces are USB 2.0 devices even in a 3.0 port) and keep USB 3.0 free for the drive. Which SSD is worth buying, why the fastest one isn't, and why the enclosure matters more than the drive does.

Download & flash

The image ships in three parts (GitHub caps release files at 2 GB each).

Installing to eMMC? Read EMMC-INSTALL.md first. Copying a root filesystem onto eMMC does not install a bootloader — you can end up running a new OS on years-old firmware, which causes crashes and reboots under load (and follows you across distros).

  1. From Releases, download both parts + the checksum: …img.xz.part00, …img.xz.part01, …img.xz.part02, …img.xz.sha256.
  2. Rejoin and verify:
    cat pi-studio-v1.4-orangepi-5b.img.xz.part* > pi-studio-v1.4-orangepi-5b.img.xz
    sha256sum -c pi-studio-v1.4-orangepi-5b.img.xz.sha256   # must print: OK
  3. Flash with balenaEtcher (on the rejoined .img.xz), or:
    xz -dc pi-studio-v1.4-orangepi-5b.img.xz | sudo dd of=/dev/sdX bs=4M status=progress conv=fsync
  4. Boot — you're in a tuned studio. First-boot tips land on the desktop.

Streaming / DRM

Chromium plays DRM streaming video at 720p — the Widevine L3 ceiling on Linux, not a Pi Studio limit. Enable Widevine using the guide that ships on the desktop; then Amazon Prime Video, Disney+, Spotify, and DRM YouTube play. Protected streams are software-decoded (normal on Linux) and play smoothly at 720p.

⚠️ Known issues — read them, we don't hide them

We ship an honest KNOWN-ISSUES register. The short version:

  • Bluetooth: the AP6275P radio's long-standing bugs are root-caused and fixed here — the boot race (Wi-Fi init starving the BT firmware load) and the Wi-Fi/BT coexistence stutter (the Cypress btc_params tuning Raspberry Pi has shipped for years, which never reached Rockchip's nvram files). The old "toggle it off and reboot" wedge is now self-healing: a watchdog revives the adapter automatically in ~10–15 s, no reboot. Details: issues #1 and #2.
  • 4K@120: validated on hardware — a full session at 120 Hz with no visible display issue. (A Chromium-specific compositing glitch can appear on some ultrawide modes when resizing a window; F11 fullscreen is always clean. Not a 4K@120 problem — see below.)
  • DRM video: 720p maximum (Widevine L3 cap, Linux-wide).

Credits

  • Kernel 4K@120 patch — jamautt
  • Bluetooth UI safety fix — sandi-pi
  • Base image — Joshua-Riek / ubuntu-rockchip
  • Widevine enabler — AsahiLinux widevine-installer (user-installed; not bundled — Widevine is Google-proprietary)
  • And the upstream projects: Sonic Pi, Ardour, PipeWire, Surge XT, and the RK3588 community.

License

See LICENSE. Built from open-source components; their licenses apply.


Built on the board everyone says is a pain — because it can do more than they think. 🐧🎶

About

A low-latency, audio-production Linux distro for the Orange Pi 5B (RK3588) — Sonic Pi, 4K@120, hardware video, fully offline & private.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors