https://github.com/1999azzar/use-rtl8188ftv-on-linux
step by step and beginner friendly for those who want to use the Realtek RTL8188FTV WiFi adapter on Linux.
https://github.com/1999azzar/use-rtl8188ftv-on-linux
linux realtek rtl8188ftv wifi-adapter wifi-network
Last synced: 2 months ago
JSON representation
step by step and beginner friendly for those who want to use the Realtek RTL8188FTV WiFi adapter on Linux.
- Host: GitHub
- URL: https://github.com/1999azzar/use-rtl8188ftv-on-linux
- Owner: 1999AZZAR
- Created: 2023-01-29T12:14:24.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-01-28T15:36:41.000Z (8 months ago)
- Last Synced: 2025-04-20T11:51:17.728Z (6 months ago)
- Topics: linux, realtek, rtl8188ftv, wifi-adapter, wifi-network
- Homepage:
- Size: 14.6 KB
- Stars: 60
- Watchers: 4
- Forks: 9
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# Realtek RTL8188FTV WiFi Adapter on Linux
This step-by-step guide is designed to help you set up the Realtek RTL8188FTV WiFi adapter on Linux. The instructions were tested on **Ubuntu 22.04.1 LTS (x86_64)** with **Linux kernel 5.15.0-58-generic**. If you're using a different distribution or version, some steps may vary. Feel free to ask questions if you encounter any issues.
---
## Prerequisites
1. **Plug in the Realtek RTL8188FTV WiFi adapter** into a USB port on your Linux PC.
2. **Boot up your Linux PC**.---
## Step 1: Open Terminal
1. Click the **Grid button** (9 dots) to open the Application drawer.
2. Search for and open the **Terminal** application.
- The Terminal window will have a black background with white text, similar to the Windows Command Prompt.---
## Step 2: Check if the WiFi Adapter is Detected
Verify that the Realtek RTL8188FTV WiFi adapter is recognized by your system.
### Option 1: Check Network Interfaces
1. Run the following command in the Terminal:
```bash
ip a
```
2. Look for a network interface with a prefix like `wlx` (e.g., `wlx1234567890ab`).### Option 2: Check USB Devices
1. Run the following command in the Terminal:
```bash
lsusb
```
2. Look for an entry similar to:
```
Realtek Semiconductor Corp. RTL8188FTV 802.11b/g/n 1T1R 2.4G WLAN Adapter
```---
## Step 3: Update System Packages
Ensure your system is up to date before proceeding.
1. Update the package list:
```bash
sudo apt update
```
2. Upgrade installed packages:
```bash
sudo apt upgrade
```
3. Install the `net-tools` package (optional but useful for network troubleshooting):
```bash
sudo apt install net-tools
```---
## Step 4: Add the Kelebek Repository
The Kelebek repository contains the driver for the Realtek RTL8188FTV adapter. Add it to your system:
1. Add the repository:
```bash
sudo add-apt-repository ppa:kelebek333/kablosuz
```
2. Update the package list again:
```bash
sudo apt-get update
```---
## Step 5: Install the WiFi Adapter Driver
Install the driver for the Realtek RTL8188FTV adapter:
1. Install the driver:
```bash
sudo apt-get install rtl8188fu-dkms
```
2. (Optional) To remove the driver later, use:
```bash
sudo apt purge rtl8188fu-dkms
```For more details, visit the [GitHub repository](https://github.com/kelebek333/rtl8188fu).
---
# Step 6: Configure the Driver
Adjust the driver configuration to ensure proper functionality:
#### 1. Disable IPS Mode (Optional but Recommended)
IPS (Inactive Power Save) mode can sometimes cause connectivity issues. Disabling it is recommended for better performance:1. Create or update the driver configuration file:
```bash
echo "options rtl8188fu rtw_ips_mode=0" | sudo tee /etc/modprobe.d/rtl8188fu.conf
```
- This command writes `options rtl8188fu rtw_ips_mode=0` to the file `/etc/modprobe.d/rtl8188fu.conf`.
- If the file already exists, it will be overwritten. To append instead, use `tee -a`.2. Reload the driver to apply the changes:
```bash
sudo modprobe -rv rtl8188fu && sudo modprobe -v rtl8188fu
```
- This unloads (`-r`) and reloads (`-v`) the `rtl8188fu` module with the new configuration.#### 2. Fix MAC Address Changes (Optional)
If the MAC address of your adapter changes after every reboot, you can set a static MAC address:1. Replace `xx:xx:xx:xx:xx:xx` with your desired MAC address and run:
```bash
echo "options rtl8188fu rtw_ips_mode=0 rtw_initmac=xx:xx:xx:xx:xx:xx" | sudo tee /etc/modprobe.d/rtl8188fu.conf
```
- This sets both `rtw_ips_mode=0` and a static MAC address (`rtw_initmac=xx:xx:xx:xx:xx:xx`).2. Reload the driver to apply the changes:
```bash
sudo modprobe -rv rtl8188fu && sudo modprobe -v rtl8188fu
```---
## Step 7: Reboot Your PC
Restart your system to ensure all changes are applied:
1. Click the **Power menu** (top-right corner of the screen).
2. Select **Restart**.---
## Step 8: Connect to Wi-Fi
Connect to your Wi-Fi network:
1. Open **Settings** from the Application drawer.
2. Go to **Wi-Fi** and turn it on if it’s off.
3. Select your network and enter the password.---
## How to Remove the Driver and PPA
If you no longer need the driver or the Kelebek repository, follow these steps:
1. Remove the driver:
```bash
sudo apt purge rtl8188fu-dkms
```
2. Remove the Kelebek repository:
```bash
sudo add-apt-repository --remove ppa:kelebek333/kablosuz
```
3. Reboot your PC to complete the removal:
```bash
sudo reboot
```---
That’s it! Your Realtek RTL8188FTV WiFi adapter should now be fully functional on your Linux PC. If you encounter any issues, refer to the [GitHub repository](https://github.com/kelebek333/rtl8188fu) or seek help from the Linux community.