Realtek rtl8188eu(s) / rtl8188etv wireless drivers

Trying to find a solution? See troubleshooting.

Support	Tested	Status	Description
Android 7+	❌	🟡	Depends on which kernel version is installed.
MESH	❌	🟠	Not tested yet.
Monitor Mode	✅	🔵	Tested and working.
Frame injection	✅	🔵	Tested and working.
Kernel 5.8+	✅	🟢	Kernel 5.15+ tested.
Kernel 6.17	✅	🟢	Tested and working (see kernel 6.3+ notes).

Kernel 6.3+ Compatibility Fixes

This fork adds fixes required to build and run on kernel 6.3 and newer (tested on 6.17).

Building

The quickest compile can presume:

git clone --depth 1 https://github.com/Kobsser/rtl8188eus.git
cd rtl8188eus/
make -j$(nproc)
sudo make install
sudo modprobe --remove rtl8xxxu && sudo modprobe 8188eu

The old driver will be kept, but it needs to be deactivated. Verify if your kernel is equal or newer than 6.3.x. If it is, then the driver to blacklist is rtl8xxxu. Otherwise it is r8188eu.

# For kernel 6.3+
echo "blacklist rtl8xxxu" | sudo tee /etc/modprobe.d/rtl8xxxu-blacklist.conf
sudo update-initramfs -u

Or with DKMS:

su -c "sh dkms-install.sh"

Secure Boot

If your system has Secure Boot enabled, the module must be signed after every install. You will need an enrolled MOK key. If you don't have one yet, see this guide.

Once your MOK key is enrolled:

sudo /usr/bin/kmodsign sha256 \
  /var/lib/shim-signed/mok/MOK.priv \
  /var/lib/shim-signed/mok/MOK.der \
  $(find /lib/modules/$(uname -r) -name "8188eu.ko")

Run this after every make install, then reload the module:

sudo modprobe --remove 8188eu && sudo modprobe 8188eu

---

All the instructions and explanations can be found by
reading the documentation or by accessing the topics:

• Building for Kali Nethuner;
• Available Modes;
• Configuring NetworkManager;
• Managed/Monitor Mode: toggle-script.

Credits

Realtek - https://www.realtek.com
Alfa Networks - https://www.alfa.com.tw
aircrack-ng - https://www.aircrack-ng.org
Project contributors - https://gitlab.com/SimplyCEO/rtl8188eus/-/graphs/master?ref_type=heads

And all those who are using, requesting support, or teaching. Thanks!