https://github.com/aircrack-ng/rtl8188eus

RealTek RTL8188eus WiFi driver with monitor mode & frame injection support
https://github.com/aircrack-ng/rtl8188eus

Last synced: 25 days ago
JSON representation

RealTek RTL8188eus WiFi driver with monitor mode & frame injection support

• Host: GitHub
• URL: https://github.com/aircrack-ng/rtl8188eus
• Owner: aircrack-ng
• Created: 2019-02-11T17:10:02.000Z (about 6 years ago)
• Default Branch: v5.3.9
• Last Pushed: 2025-02-03T22:40:08.000Z (3 months ago)
• Last Synced: 2025-04-11T22:21:44.594Z (25 days ago)
• Language: C
• Homepage:
• Size: 5.25 MB
• Stars: 1,022
• Watchers: 48
• Forks: 414
• Open Issues: 146
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-hacking-lists - aircrack-ng/rtl8188eus - RealTek RTL8188eus WiFi driver with monitor mode & frame injection support (C)

README

        
## rtl8188eus v5.3.9

# THESE DRIVERS IS DEPRECATED.

# Use the mac80211 drivers over at [https://github.com/lwfinger/rtw88](https://github.com/lwfinger/rtw88)

# Realtek rtl8188eus & rtl8188eu & rtl8188etv WiFi drivers

[![Monitor mode](https://img.shields.io/badge/monitor%20mode-supported-brightgreen.svg)](#)

[![Frame Injection](https://img.shields.io/badge/frame%20injection-supported-brightgreen.svg)](#)

[![MESH Mode](https://img.shields.io/badge/mesh%20mode-supported-brightgreen.svg)](#)

[![GitHub issues](https://img.shields.io/github/issues/aircrack-ng/rtl8188eus.svg)](https://github.com/aircrack-ng/rtl8188eus/issues)

[![GitHub forks](https://img.shields.io/github/forks/aircrack-ng/rtl8188eus.svg)](https://github.com/aircrack-ng/rtl8188eus/network)

[![GitHub stars](https://img.shields.io/github/stars/aircrack-ng/rtl8188eus.svg)](https://github.com/aircrack-ng/rtl8188eus/stargazers)

[![GitHub license](https://img.shields.io/github/license/aircrack-ng/rtl8812au.svg)](https://github.com/aircrack-ng/rtl8188eus/blob/master/LICENSE)


[![Android](https://img.shields.io/badge/android%20(8)-supported-brightgreen.svg)](#)

[![aircrack-ng](https://img.shields.io/badge/aircrack--ng-supported-blue.svg)](#)

# Supports

* Android 12/13

* MESH Support

* Monitor mode

* Frame injection

* Up to kernel v6.5+

... And a bunch of various wifi chipsets

# 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  down

sudo iw dev  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 

```

# 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!