Pneuma

Arch Linux Wireless Repeater & TTL Injector Utility

---

Pneuma is a specialized CLI utility designed for Arch Linux (Hyprland/Sway/i3) environments. Unlike standard GNOME/KDE hotspots that require a wired connection to share internet, Pneuma functions as a Single-Radio Repeater.

It allows you to receive Wi-Fi and share it simultaneously using a single network card (wlan0), with built-in traffic masking.

---

Why Pneuma?

• Native Repeater Mode: Share the Wi-Fi you are connected to without disconnecting. No Ethernet needed.
• Bypass ISP Limits: Automatically injects TTL=65 into outgoing packets. Connected devices appear as native traffic, bypassing hotspot quotas/throttling (tested on various providers).
• Smart Channel Sync: Automatically scans and locks onto the source Wi-Fi channel to prevent Interface Busy or RTNETLINK errors common in single-card setups.
• Auto-Fix Driver: Includes a --fix flag to hard-reset Wi-Fi radios when drivers get stuck in a zombie state.

---

Requirements

• OS: Arch Linux (Recommended). Ubuntu/Debian supported if you build linux-wifi-hotspot from source.
• Dependencies:
  • linux-wifi-hotspot (AUR) - Core Engine
  • networkmanager (nmcli)
  • iptables
  • iw

---

Installation (Arch Linux)

# 1. Clone The Repository
git clone https://github.com/rannd1nt/pneuma.git
cd pneuma

# 2. Install dependencies
# Note: If you use paru, replace yay with paru
sudo pacman -S networkmanager iptables iw procps-ng
yay -S linux-wifi-hotspot

# 3. Install Pneuma
chmod +x pneuma
sudo mv pneuma /usr/local/bin/

---

Usage Example

• Bring Hotspot UP (Auto-Mode):
  

  pneuma --up
  # or: pneuma -u

• Bring UP with Specific Target:
  

  pneuma -u "CoffeeShop_WiFi"

• Bring Hotspot DOWN:
  

  pneuma --down
  # or: pneuma -d

• Setup SSID & Password
  

  pneuma --set-ssid "My_Repeater" --set-pass "Password"

• Hard Reset Driver:
  

  pneuma --reset
  # or: pneuma -r

• View Configuration:
  

  pneuma --config
  # or: pneuma -C

License

MIT License. Free to use and modify.