aircrack-ng / rtl8188eus

RealTek RTL8188eus WiFi driver with monitor mode & frame injection support
979 stars 408 forks source link

rtl8188eus v5.3.9

Realtek rtl8188eus & rtl8188eu & rtl8188etv WiFi drivers

Monitor mode Frame Injection MESH Mode GitHub issues GitHub forks GitHub stars GitHub license
Android aircrack-ng

Supports

Howto build/install

  1. Compile and install the driver:
    cd rtl8188eus
    make && sudo make install
  2. Blacklist another drivers in order to use this one:
    echo 'blacklist r8188eu' | sudo tee -a '/etc/modprobe.d/realtek.conf'
    echo 'blacklist rtl8xxxu' | sudo tee -a '/etc/modprobe.d/realtek.conf'
  3. reboot or remove all drivers related to RTL8188 and reload this one:
    rmmod r8188eu rtl8xxxu 8188eu
    modprobe 8188eu

MONITOR MODE howto

Use these steps to enter monitor mode.

sudo airmon-ng check kill
sudo ip link set <interface> down
sudo iw dev <interface> set type monitor

Frame injection test may be performed with (after kernel v5.2 scanning is slow, run a scan or simply an airodump-ng first!)

sudo aireplay-ng -9 <interface>

NetworkManager configuration

Add these lines below to "NetworkManager.conf" and ADD YOUR ADAPTER MAC below [keyfile] This will make the Network-Manager ignore the device, and therefore don't cause problems.

[device]
wifi.scan-rand-mac-address=no

[ifupdown]
managed=false

[connection]
wifi.powersave=0

[main]
plugins=keyfile

[keyfile]
unmanaged-devices=mac:A7:A7:A7:A7:A7

Credits

Realtek - https://www.realtek.com
Alfa Networks - https://www.alfa.com.tw
aircrack-ng. - https://www.aircrack-ng.org

And all those who may be using or contributing to it of anykind. Thanks!