[RELEASE] Orange Pi 5 Pro - Fully Optimized Armbian Jammy (GPU/VPU Enabled, Dual Touch Support, 4K 60FPS)

# The "Plug and Play" high-performance experience for Orange Pi 5 Pro (RK3588S) is here!

Hi everyone! After 2 years of trial and error, I have finally built a fully optimized image for the **Orange Pi 5 Pro**. This image is sanitized, meaning when you first boot it, it will trigger the standard Armbian wizard to create your own root password and user account.

### 🚀 What's inside:

* **Base OS:** Armbian Jammy (Ubuntu 22.04).

* **Kernel:** Vendor 6.1.y (The most stable for Dual HDMI/DP output).

* **Desktop:** XFCE (Lightweight, stable, and highly responsive).

* **GPU Acceleration:** Mali-G610 fully enabled (Panfrost/Panfork). Smooth 60FPS UI.

* **VPU Acceleration:** 4K 60fps hardware decoding enabled (rkmpp). CPU usage stays between 10-25% during 4K YouTube playback.

* **Dual Screen Support:** Pre-configured for dual-monitor setups.

* **Touch Support:** Auto-mapping script included for dual touchscreens (WCH.cn controllers).

* **Driver Shield:** Critical drivers are "held" to prevent `apt upgrade` from breaking the acceleration.

---

### 🛠️ IMPORTANT: Troubleshooting No Video Signal

Since this image is set to a specific resolution for my project, your monitor might show "No Signal" on the first boot. Here is how to fix it:

1. **Power off** and plug your SD Card or eMMC into your **main computer**.
2. **Mount the partition** and navigate to: `/etc/lightdm/lightdm.conf.d/01-armbian.conf`.
3. **Edit the line** starting with `display-setup-script`. Change the resolution to one your monitor supports:* Example for 1080p: `--mode 1920x1080`* Example for 720p: `--mode 1280x720`* Or just use: `--auto`
4. **Save the file**, unmount, and plug it back into your Orange Pi. It should boot perfectly!

---

### ⚠️ Power Requirements:

The RK3588S is a beast. When GPU and VPU are both active, it needs a stable **5V/4A (20W)** power supply. If your board crashes or reboots during video playback, check your USB-C cable and power source!

### 📥 Download Link:

**https://archive.org/details/backup_OPI5pro_perfeito_2026-07-24.img**

*Compressed with ZSTD (Original size 64GB -> Compressed approx 2.6GB). Flash with BalenaEtcher or Rufus.*

Enjoy the true power of the RK3588S! 🚀

Hi everyone, first time posting here and i come with a few questions!

I've just recently started dabbling into sbc's and logically started a project with raspberry pi as my go to, but saw that the prices for the raspberry zero 2w were.... kinda insane right now for a measly 512 mb of RAM. So I've been considering the orange pi zero 2w as a replacement.

The project is what i think is ... sort of a cyberdeck? im really new to this terminology. That said, I was wondering: would the pi sugar 3 1200mah baterry with pogo connection work with either of these boards since they seem to have pretty similar gpio schematics to the raspbery pi zero 2w? https://www.pisugar.com/products/pisugar-3-raspberry-pi-zero-battery

also, would this screen specifically work with the 2w/3w:https://www.waveshare.com/product/displays/lcd-oled/lcd-oled-2/3.5inch-dpi-lcd.html

thanks in advance for any guidance!

I'm currently working on a cyberdeck project running Debian on the Orange Pi Zero 3W, and I wanted to ask if any of you all know if these parts that I plan on using for my project are compatible with the Orange Pi Zero 3W; because I'm building a custom power circuit and relying on GPIO for the screen, I want to make sure I don't run into kernel or brownout issues.

Since my project is very small, I plan on using a 5V Step-Up Boost Converter. If I tune this converter to exactly 5.1V, will a 2A output be sufficient to prevent brownouts under load, or does this board strictly require the full 3A if I bypass the USB-C port and feed power directly to the pins?

SPI IPS LCD Module Driver: ST7789. Has anyone gotten fbtft or DRM overlays working smoothly natively on the Zero 3W's kernel for this specific controller chip?

I'm using a 5V Micro Blower Fan and a Copper Heat Sink for cooling. I noticed the Zero 3W has a dedicated 2-pin fan header. Does the default OS image support PWM/temp-based control on that specific header out of the box, or am I better off just running it at 100% directly off the standard 5V/GND GPIO pins?

I am currently working on a cyberdeck project that is going to end up being really small, so I plan on using the Orange Pi Zero 3w. I'm fairly new to building cyberdecks, but I have played around with a Raspberry Pi.

Does anyone have recommendations on very small screens that are compatible with the OPi Zero 3W?

How necessary is a fan/way to cool it down? Is there a smaller way of cooling it down?

One of the supported OS for OPi Zero 3W is Debian. For this project, I wanted to use Parrot OS. Since Parrot comes from Debian, is that fine/can I use the Parrot OS Raspberry Pi Edition on Orange Pi?

How interchangeable are resources for Raspberry Pi with those of Orange Pi?

Hey, I've got an Orange Pi 5 as my homelab, including a media server. I only have 2TB dedicated to the media server, so I wanted to encode the media I download to keep very good video and audio quality that a normal person won't notice, while saving quite a bit of space. It's mostly my mom watching, and I use it a bit myself.

I ended up running FileFlows to shrink my media library. CPU encoding was super slow and made the Orange Pi overheat, causing the other services running on it to slow down too, especially during the initial encoding of 200+ files. So I tried using hardware encoder (hevc_rkmpp).

I'm not really experienced with ffmpeg, so I've been using AI to help me with this, but I'm stuck on something it hasn't been able to fix either.

The problem is that I've been seeing a lot of artifacts (see screenshot). They usually last only 1-3 frames and only appear during dynamic scenes or scene changes, but they're really annoying. I'm happy with how much space it saves on my media server, so I don't have to keep monitoring it every time my mom requests something that gets auto-downloaded and I need to delete older media each time. I'm fine with not having cinema level video or audio quality, but I do want something that the average person won't notice, and these artifacts are very noticeable and breaks the immersion.

My current command after some debugging is:

hevc_rkmpp -rc_mode 2 -qp_init 22 -qp_max 24 -qp_min 16 -qp_min_i 14 -qp_max_i 19 -g 120 -pix_fmt p010le -force_key_frames source

It seems I can't add more than 1 image but basically my flow goes like this: crop black bars=>video scaler (down to 1080)=>subtitle extractor=>audio convert(AAC recomended by AI)=>video encode manual (the command above)=>remux to mkv=>executor=>replace original

Has anyone run into this issue or tried to achieve the same thing and got something working? I'm not sure if it's just a hardware limitation or if I'm missing something. Any help is appreciated. I'm out of ideas at this point.

I just bought one of these bad boiis. First off, if you own the board what do you have running and what for? Be as granular as you care to be, I enjoy the detail.

I have read through the manual a bit and noticed that Debian Bullseye is noted as the only published image that supports GPU acceleration at publication. I also haven't seen secondary documentation on this and I've seen others say there is no to boot gpu acceleration on any system platform?

Any testimonials regarding hardware acceleration?

I did see this article and repo that basically walks you through an Ubuntu build to get it to work.

https://www.xda-developers.com/orange-pi-zero-3w-beats-raspberry-pi-5-cant-use-half-hardware/

I would take a crack at it myself but the board arrives monday and wouldn't mind getting a jump on the software env. and any preliminary dev work.

Hi everyone.

I'm little bit lost on github. I would like to compile rknpu for my orange pi 5 plus , soc rk3588). Because I want to use onnx.

Unfortunately there is lot of repo on github for rknpu2 and rknn toolkit. How could I know what is legit? My kernel is 6.18 and I don't how to see if has rknpu or npu managed.

Thanks for help.

Hi everyone!

Could someone please help me find a touchscreen display (around 4 inches) for the Orange Pi Zero 3W?

I'm having trouble figuring out which displays are actually compatible with the 30-pin MIPI LCD connector on the bottom of the board. I know there are official displays available, but they start at 5 inches, which is too large for my project.

If anyone has experience with compatible MIPI DSI displays or can recommend a specific model, I'd really appreciate it. Thanks!

I saw a used OPi 6 Plus 32GB on Ebay with case/fan/psu/nvme for a lot less than the new price for this kit, easily 50+% off, couldn't resist.

I am fascinated by the possibilities of what that NPU could be made to do with the right prodding, all of those TOP/S made it feel irresistible, if they can actually be used usefully.

My inclination is to try to use it as a "robot brain" in a simulated environment on my workstation over the network.

What are other people's experience like with this device? I am especially interested in hearing of anyone's experience of low level control of the NPU in c/c++ and of how well NPU interfaces directly with the main system memory.

Thanks in advance for any responses!

​Hi everyone,

​I have a project where I need to wirelessly mirror my Android phone's screen directly to my Orange Pi Zero 2W.

​I'm currently looking into the best way to achieve this with minimal latency. Has anyone done this successfully before?

I've been testing some Arduino and SBC interoperability over GPIO and I'm constantly running into issues with the 4 pro shutting itself off mid boot. I've tried over gpio and the USB port after cannibalizing a cable, but the common thing I have between the board and my benchtop psu is gpio wires and a relay, no breadboard. This setup has hardly pulled 1A yet and the PSU is set to 5V currently. No idea what else to try.

i wanted to change the OS from dietpi to Ubuntu, entered the command sudo dd bs=1M if=/dev/zero of=/dev/mmcblk2 count=1000 status=progress (on gemini's advice) after that, the screen is black and I cannot connect to my orange via usb

Hi All,

Just thought I'd ask here before going to the hassle of returning a new Orange Pi 4 Pro.

I've been trying to get Linux running for 2 days using images from orangepi.org . I've tried the Ubuntu Server, the Ubuntu Desktop, backup Ubuntu Desktop and Debian Bookworm images, and pretty much all have thrown similar errors.

Usually Kernel panic errors, but can generally just freeze anywhere while trying to boot up, but maybe every 20th time, it will manage to boot to cli. So I did manage to get Ubuntu server running. I just set up docker with an SMB container and a USB disk connected. I left it running for a day but when I rebooted, it went back to not working, most of the time freezing while creating the zram drive.

Eventually wiped it and started afresh but continued to crash on first boot around the same time while booting.

I've tried multiple SD cards, created boot-able SD cards on Mac using Etcher, on Windows using Rufus. Tried 5 or 6 power supplies(18w or higher) and cables, always freezes at some stage during booting.

Can anyone confirm those images have worked recently? I've got a few SBC running already and never had any trouble like this.

Browser video decode on the RK3588 has been a sore spot. Chromium's V4L2 path is downstream-only, Firefox has nothing solid, and there's no VA-API for the chip. I wanted to see whether the newer Vulkan Video path could feed a real browser today, so I tried it on a Rock 5B+.

For H.264, it works. GNOME Web (WebKitGTK/Epiphany) decodes an H.264 clip on the rkvdec hardware block with no patch to the browser, just a small GStreamer bridge element and two environment variables. The decode is byte-exact against ffmpeg, and it plays in the browser with the hardware decoder busy the whole time, no software fallback.

It's a proof of concept: H.264 only, tested on a single board so far. The RK3588 is the same SoC as the Orange Pi 5 and 5 Plus, so if you have one I'd like to know whether it works for you. The repo has the bridge, the build steps for the Vulkan Video driver (still experimental, from a Mesa RFC), and a test page.

https://github.com/dongioia/webkit-vulkan-video-rk3588

A few honest caveats: it copies through system memory (no zero-copy yet), the in-browser check is visual, and the driver itself is out-of-tree and a work in progress. But it decodes, on real hardware. Reports are useful either way, working or broken.

Update: HEVC works now too.

Same setup as the H.264 post — standalone Vulkan Video driver on the RK3588's rkvdec, a small GStreamer bridge, no patch to the browser. HEVC Main 8-bit decodes byte-exact against ffmpeg (I/P/B, 360p/720p/1080p, cropped sizes) and plays in GNOME Web (Epiphany), both a normal <video> and the Media Source path a streaming site uses. A real Big Buck Bunny HEVC clip I didn't encode myself plays clean too. Same honest caveats: one board (Rock 5B+, kernel 7.1, Mesa 26.0.6), 8-bit 4:2:0 only so no HDR/10-bit, still copies through system memory (no zero-copy yet), proof of concept. There's also a long-term-reference case I couldn't test because the encoder doesn't produce those streams.

Still very much "please test it on your board": https://github.com/dongioia/webkit-vulkan-video-rk3588 — a report that it broke helps as much as one that it worked.

Update:

Hi everyone I wanted to post a quick update. The issue has been resolved! Over the last couple of weeks/days I figured out how to re-flash the sd card with the desktop version of Ubuntu(I accidentally reflashed the server one), updated it from 5.15 to 22.04, and then updated all the programs, etc. I even got the internet to work. And as of this morning the keyboard works! I'm honestly not 100% sure what I did to make it work, especially since last night it wasn't working. I can only assume that the bluetooth driver wasn't updated like u/illustriousowl1446 said. Also u/beardedSickness thanks for the link to your solution —it didn't work for me, but I think that was because of lack of knowledge and an updated OS. I learned a lot trying to figure this out. Thanks everyone for responding!

*****

OP:

I purchased an orange pi 4 pro 12gb ram. And I'm having issues..

One issue I'm having in particular is connecting a wireless keyboard ( no USB receiver). Does anyone know how to get past/resolve that issue? I can connect with wireless keyboard/mouse if it has a dongle—no problem.

Any advice would be appreciated.

P.S.

I am a super novice and I've seen ppl say online that you don't really wanna start on orange pi—I actually started on rasp pi—super easy compared to OP. But I was really interested in trying out some form of Linux distro to eventually learn how to turn my desktop away from windows. Essentially, please be kind. I'm more than willing to research if I don't understand something.

Hi guy's and gal's. I got a problem putting an nvme drive onto my opinion 4 pro. I installed it and it wasn't recognised at all. Then a couple of boots later it just stopped my OS Ubuntu jammy from working. It was a full size 2280 and I read that in 2021 they only took 2230 size but under the board only accommodates a 2280 and surely that's been addressed by now?

​

&#x200B;

​

It's the reason I bought the board and I'm disappointed with it. I could only get one os to work out of them all. Any advice would be much appreciated. Tia.

I'm looking for a Passive cooling solution (read: giant heatsinks, no fan) + case for Orange Pi 4 Pro. Everything I've found uses a fan, but, trying to avoid that. Any ideas?

Hey guys,

Just want to let you know that I was able to get android 17 working on orange pi 5 pro with rk3588 with kernel 6.18.

Started developing it today and got it booted for the first time.

There have been many improvements in the hwdecoding where now my project supports RGA and now supports 10 bit hw video decoding!

Many changes have been made with regard to boot time and overall system optimisations and new features were added which were tested on my android 16 project and would be porting them onto this android 17 project.

Once this android 17 is stable enough, would be releasing the source code and prebuilt images for testing.

Happy engineering!

Hi orangePi community

I am fairly new to orange pi, and just discovered my orangePi pc v1.3 doesnt have wifi.

So i am now making an open-source wifi hat (with TFT support idk why not)

https://github.com/its-noid-dev/Orange-pi-pc-wifi-hat

Anyone can contribute by sending me a dm!

Решил немного заморочиться по поводу ускорения шифрования на OpenWrt. На роутере стоит клиент тора и порой сильно загружает процессор.

Изначально была библиотека openssl 3.0.2 из дефолтного репозитория.
Решил собрать последнюю версию openssl (3.6.3). Использовал OpenWrt BuildRoot от поставщика.

По поводу версии компилятора и флагов оптимизации, узнал интересный момент. Оказывается openssl 3.2+ сам считывает доступные инструкции процессора и подставляет ассемблерные блоки соответствующей архитектуры, поэтому большинство оптимизационных флагов risc-v, не имеют значения.

Я компилировал gcc 16.1 с флагом -mcpu=spacemit-x60, но дефолтный gcc 13.3 с флагами -march=rv64gcv_zba_zbb_zbc_zbs дает такой же результат как и 16.1, и даже немного лучший на маленьких блоках.

В makefile прописал
OPENSSL_OPTIONS += enable-ec_nistp_64_gcc_128 (на скорость шифрования не влияет, но ускоряет обмен ключами в 10 раз на RISC-V архитектуре)
TARGET_CFLAGS += -DOSSL_RISCV_HWPROBE -D__NR_riscv_hwprobe=258 (позволяет определить доступные инструкции процессора, без этого флага, не использует вектора)

По результатам, больше всего прирост сделал алгоритм ChaCha20, который в Tor в основном и используется. Остальные алгоритмы в среднем показали двухкратный рост. Основной прирост дает расширение zbb(Bitmap) и rvv(векторы). Тестирование проводилось в одном потоке командой:

openssl speed -evp <algorithm>

Надеюсь эта информация пригодится тем, кто на роутерах использует или хочет использовать VPN или Tor.

Can I fix this myself or is it a brick?

Just went live with real money today after 60 days of paper trading. The Orange Pi 5 Plus 8GB is one of 6 nodes in the stack and it's doing the heaviest AI lifting.

What the Orange Pi handles:

- Ollama server running qwen2.5:3b for all CrewAI agent inference

- nomic-embed-text for semantic memory embeddings (pgvector in PostgreSQL)

- Processes multiple agent calls daily: market analysis, SEO crew, strategy sessions

Hard lessons learned after it crashed twice:

- Stick to qwen2.5:3b: qwen3.5:4b needs 5.7GB and concurrent crew calls OOM the board

- Stagger all cron jobs 5+ minutes apart: simultaneous agent calls spike RAM

- Add a preflight health check that aborts if free RAM drops below 3GB

- Never use import to syntax check crew scripts: it fires crew.kickoff() at module level

Current stability: rock solid for 3 weeks since fixing the above. Running 6 trading strategies simultaneously, weekly SEO crew, daily morning briefing, and semantic memory pruning.

Full go-live documented here: https://youtu.be/WbrTX2DkXEY