Installation¶

Requirements¶

A supported Realtek PCIe card — see Supported Hardware.
Xcode Command Line Tools.
The macOS Kernel SDK (MacKernelSDK).
The Linux rtw88 driver source from thegwchr/rtw88-stable.

Download from releases¶

The easiest way to get Feixiao is the prebuilt release — no toolchain required.

Grab the Feixiao_vX.Y.Z_*.zip asset from the Releases page and unzip it — it contains rtw88.kext and the rtw88ctl utility. Then skip straight to Loading the kext.

Prefer to compile it yourself? See Building from source.

Building from source¶

Clone the repository and its submodules:

git clone https://github.com/thegwchr/Feixiao.git
cd Feixiao
git submodule update --recursive

Clone the rtw88 source alongside it:

git clone https://github.com/thegwchr/rtw88-stable.git

Directory layout

The build expects the rtw88-stable source in the layout described in the project README. Place it where the Makefile expects before building.

Build the kext and the control utility:

make all

The compiled kernel extension (rtw88.kext) and the command-line utility (rtw88ctl) are written to build/out/.

Loading the kext¶

Manual (testing)OpenCore (Hackintosh)

sudo chown -R root:wheel build/out/rtw88.kext
sudo kextload build/out/rtw88.kext

You may be prompted to approve the extension in System Settings → Privacy & Security.

Inject rtw88.kext via OpenCore — copy it into EFI/OC/Kexts and add it to config.plist under Kernel → Add.

Next steps¶

Once loaded, use the rtw88ctl utility to check status, scan, and connect — or install Starskiff for a menu-bar GUI.