connex - Modern Wi-Fi Manager

Connex is a modern and intuitive Wi-Fi manager for Linux, powered by NetworkManager, offering a clean interface, a full CLI mode, seamless desktop integration, VPN and proxy management, hidden network support, QR-code pairing, and even a built-in speedtest for a complete networking experience.

Features

• Simple and modern interface
• Connect, disconnect, and manage Wi-Fi networks
• Hidden network support
• Connection history
• Built-in speedtest
• Command-line mode
• QR code connection
• Proxy system
• VPN Management (WIP)

Installation

You can install using this one-line command (recommended):

curl -sSL https://raw.githubusercontent.com/Lluciocc/connex/master/install.sh | bash -s -- --clone

You can also install it manually by cloning the repository and running the installer:

git clone https://github.com/lluciocc/connex.git
cd connex
chmod +x ./install.sh
./install.sh

Compatibility

Distribution	Status
Arch Linux	✅
Linux Mint	✅
Ubuntu	✅
Debian	❓
Fedora	✅
openSUSE	❓
Manjaro	❓
Pop!_OS	❓
Elementary OS	❓
Zorin OS	❓
Kali Linux	❓
EndeavourOS	❓
Rocky Linux	❓

Note

Everything marked with ❓ has not been tested yet, your help would be greatly appreciated!

Usage

GUI Mode

# Launch main window
connex

# Launch with debug logging
connex --debug

# Launch in system tray and window
connex --tray

# Launch only the tray
connex --tray-only

CLI Mode

# List available networks
connex --cli list

# Connect to a network
connex --cli connect --ssid "MyNetwork" --password "mypassword"

# Disconnect from current network
connex --cli disconnect --ssid "MyNetwork"

# Show connection status
connex --cli status

# Run a speedtest
connex --cli speedtest

Troubleshooting

#Enable Debug Mode
connex --debug

# Launch without automatic scan
connex --no-scan

Configuration

connex stores its configuration and logs in:

• Config Directory: ~/.config/connex/
• Connection History: ~/.config/connex/history.log

Dependencies

• python (>=3.9)
• python-gobject
• gtk3
• networkmanager
• libappindicator-gtk3
• libnotify
• python-qrcode

Optional Dependencies

• papirus-icon-theme - For better icon aesthetics
• hyprland - Recommended window manager

Keyboard Shortcuts

• CTRL + H - Open Hidden Network dialog
• CTRL + R - Refresh the network list
• CTRL + F - Focus on the search bar
• CTRL + Q - Quit

Screenshot

License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Support

If you like my work, please consider buying me a coffee :)

Made with ❤️ for the Linux communities