Skip to content

xe5700/kvmd-armbian

Repository files navigation

KVMD-ARMBIAN

This project support non Raspberry Pi device to running pikvm on armbian You can try other project based on pikvm fork version of kvmd-armbian https://github.com/srepac/kvmd-armbian onekvm project https://github.com/mofeng-git/One-KVM

Chinese installation steps

Chinese installation steps by toss-a [https://github.com/xe5700/pikvm-armbian/blob/master/README-zh-CN.MD]

Install

KVMD Install for armbian It support Allwinner, Amlogic and Rockchip based tv box, tested on phicomm n1, mxq pro 4k, tqc a01. Chipset needs support USB OTG feature, lots of old amglogic chipset not support otg feature, such as s805 and s905. You should install armbian with debian buster or bullseye. Then running this script to install pikvm. Install scripts is fork from @srepac rasbian pikvm install script.

Original Script [https://kvmnerds.com/RPiKVM/install-pikvm-raspbian.sh]

Hardware for kvmd-armbian project

  • A tv box/arm board supports otg feature:
    • Tests on phicomm n1(Amlogic s905d), mxq pro 4k (rk322x), tqc a01(Allwinner H6).
    • If you are use arm board you can remove gpio patch to enable gpio feature.
  • Video capture device:
    • HDMI to USB dongle (30 RMB On taobao, 10$ on aliexpress.) cheap hdmi to usb dongle all use physics USB2.0 port, but fake USB3.0(USB 5GBPS, USB3.2GEN1) version supports 720P 60FPS, usb 2.0 version only supports 720P 30FPS.
  • USB-A to USB-A cable:
    • Recommended cut off usb cable's power line, it might causes otg disconnect.

Step 1

  • Flash armbian debian [Recommended bullseye] for your tv box (If kernel not support otg you should build a kernel enable otg features)

Step 2

  • Modify your dtb file to enable otg feature. Change dr_mode from host to peripheral for otg usb port.
  • If you use rk322x (rk3228A rk3228B rk3229) series chipset, you can use dtb/4.4/rk332x-box.dtb

Step 3

git clone https://github.com/xe5700/kvmd-armbian.git
cd kvmd-armbian
./install.sh

(If very slow, you can use install-mirror.sh to boost install speed.)

Step 4

  • running install.sh or install-mirror.sh after reboot os then running again.
  • Enjoy

Tested device

  • Phicomm N1
  • TQC A01 (Ethernet port not working, only support wireless.)
  • RK322x based tvbox (MXQ, V88)
  • S905L2 based tvbox
  • Orange pi zero (tested by @MrSuicideParrot)

Update log

Version 1.0

Version 2.0

Now support download hook, config file, diffrent version of kvmd, and fix lots of bug. 

Version 2.1

Fix #8 #7 #15, allow custom apt manager tools.

About

KVMD For Armbian Install Script

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published