lenovo-gentoo/scripts/wifi-setup/README.md

WiFi Setup Tool

Easy WiFi connection management for Gentoo using NetworkManager.

Prerequisites

NetworkManager must be installed and running:

sudo rc-update add NetworkManager default
sudo rc-service NetworkManager start

Installation

1. Install the main script

sudo cp wifi-setup /usr/local/bin/wifi-setup

2. Install ZSH autocompletion

sudo mkdir -p /usr/local/share/zsh/site-functions
sudo cp _wifi-setup /usr/local/share/zsh/site-functions/_wifi-setup

3. Reload ZSH completions

# In your current shell
compinit

# Or just restart your shell

Usage

List available networks

wifi-setup
wifi-setup scan

Connect to a network

wifi-setup connect "NetworkName"

You'll be prompted for the password if needed. The password is stored securely by NetworkManager in an encrypted keyring.

Show current connection status

wifi-setup status

Disconnect from WiFi

wifi-setup disconnect

List saved connections

wifi-setup list-saved

Forget a saved network

wifi-setup forget "NetworkName"

Get help

wifi-setup help

ZSH Autocompletion

The completion script provides:

• Tab completion for all commands
• Tab completion for available network names when using connect
• Tab completion for saved connections when using forget

Example:

# Press TAB to see all commands
wifi-setup <TAB>

# Press TAB to see available networks
wifi-setup connect <TAB>

# Press TAB to see saved connections
wifi-setup forget <TAB>

Security

Password Storage

• Passwords are stored securely by NetworkManager in /etc/NetworkManager/system-connections/
• Files are encrypted and only readable by root
• The script uses --ask flag to prompt for passwords interactively
• No passwords are logged or stored in plain text

Network Permissions

• Network configuration requires root privileges
• NetworkManager handles authentication securely
• Saved connections auto-connect on boot by default

Auto-Connect on Boot

By default, NetworkManager will automatically connect to saved networks when they're in range. To verify or change this behavior:

# Check if auto-connect is enabled for a connection
nmcli connection show "NetworkName" | grep autoconnect

# Disable auto-connect for a specific network
nmcli connection modify "NetworkName" connection.autoconnect no

# Enable auto-connect
nmcli connection modify "NetworkName" connection.autoconnect yes

Hardware Information

WiFi Adapter: MediaTek Wi-Fi 7 MT7925 2x2 BE + Bluetooth 5.4 Interface: wlp194s0 Driver: mt7925e (kernel module)

Troubleshooting

WiFi interface not showing up

# Check if driver is loaded
lsmod | grep mt7925

# Check kernel messages
dmesg | grep mt7925

# Check interface status
ip link show wlp194s0

NetworkManager not running

# Check service status
rc-service NetworkManager status

# Start service
sudo rc-service NetworkManager start

Can't connect to network

# Check if the network is in range
wifi-setup scan

# Try connecting with verbose output
nmcli --ask device wifi connect "NetworkName"

# Check NetworkManager logs
journalctl -u NetworkManager
# Or on OpenRC:
tail -f /var/log/messages | grep NetworkManager

Reset a problematic connection

# Forget the network
wifi-setup forget "NetworkName"

# Reconnect from scratch
wifi-setup connect "NetworkName"

Technical Details

Script Features

• Color-coded terminal output for readability
• Automatic SSID detection from NetworkManager
• Support for saved connections (no re-entering passwords)
• Secure password prompting using NetworkManager's --ask flag
• Network signal strength display
• Current IP address display when connected

Dependencies

• nmcli (NetworkManager command-line client)
• grep, awk, cut (standard text processing tools)
• ip (network configuration tool)
• ZSH (for autocompletion)

Files in This Directory

• wifi-setup - Main WiFi management script
• _wifi-setup - ZSH completion script
• README.md - This documentation