Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

8 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Hotspot Manager Logo

๐Ÿ”ฅ Hotspot Manager

Concurrent WiFi + Hotspot for Linux
Share your WiFi connection while staying connected

Release License Issues Stars

Installation โ€ข Usage โ€ข Screenshots โ€ข Compatibility โ€ข Contributing


๐ŸŽฏ What is this?

Hotspot Manager is a native Linux GTK3 application that solves a common problem: how to share your WiFi connection with other devices while you're still using it.

Normally, when you create a hotspot on Linux, your WiFi disconnects. This app enables concurrent mode - you stay connected to WiFi for internet access while simultaneously broadcasting a hotspot that other devices can connect to.

Perfect for:

  • ๐Ÿ“ฑ Sharing hotel WiFi with your phone, tablet, and laptop
  • ๐ŸŽฎ Creating a local network for multiplayer gaming
  • ๐Ÿข Sharing a single WiFi connection at conferences or meetings
  • ๐Ÿ  Extending WiFi range to devices that have weak reception

โœจ Features

Feature Description
๐Ÿ”€ Concurrent Mode WiFi + Hotspot at the same time
๐Ÿ”Œ Ethernet Sharing Share wired connection via WiFi hotspot
๐Ÿ–ฅ๏ธ GTK3 GUI Clean, native Linux interface
๐Ÿ“ System Tray Quick toggle from notification area
๐Ÿ” Hardware Detection Auto-detects concurrent mode support
๐Ÿ“ฑ Device List See who's connected to your hotspot
โŒจ๏ธ CLI Interface Script and automate hotspot management
๐Ÿ”„ Auto-Recovery Restarts hotspot when WiFi reconnects
๐Ÿ’พ Config Save Remember your hotspot settings
โšก Forced Mode Virtual interfaces for incompatible hardware

๐Ÿ“ธ Screenshots

Main Window System Tray


๐Ÿ“ฆ Installation

Option 1: Download DEB (Recommended)

Download the latest .deb from Releases:

wget https://github.com/davytheprogrammer/hotspot-manager/releases/latest/download/hotspot-manager.deb
sudo dpkg -i hotspot-manager.deb
sudo apt install -f

Option 2: From Source

git clone https://github.com/davytheprogrammer/hotspot-manager.git
cd hotspot-manager
sudo ./install.sh

Dependencies

The packages are automatically installed with the .deb, but for source installation:

sudo apt install python3-gi gir1.2-gtk-3.0 gir1.2-appindicator3-0.1 \
    network-manager iw hostapd dnsmasq libnotify4 arp-scan

๐Ÿš€ Usage

GUI

  1. Connect to WiFi first - Join a WiFi network normally
  2. Open Hotspot Manager from your application menu
  3. Enter hotspot name and password (min 8 characters)
  4. Click Start Hotspot
  5. Other devices can now find and connect to your hotspot

CLI

# Check status
hotspot-cli status

# Check hardware support
hotspot-cli interfaces

# Start hotspot
hotspot-cli start --ssid MyHotspot --password mypassword123

# Stop hotspot
hotspot-cli stop

# Advanced options
hotspot-cli start --ssid MyHotspot --password secret \
    --channel 6 --band bg --interface wlan0

System Tray

The app runs in the system tray. Right-click to:

  • Toggle hotspot on/off
  • Show the main window
  • Quit the application

โš™๏ธ Compatibility

Supported OS

  • Ubuntu 20.04+ / Pop!_OS
  • Debian 11+
  • Linux Mint 20+
  • Any Debian-based distribution with NetworkManager

Hardware Requirements

Not all WiFi cards support concurrent mode. Check yours:

hotspot-cli interfaces

Or manually:

iw phy | grep -A10 "Supported interface"

Look for both * AP and * managed in the output. Cards with AP/VLAN typically support concurrent mode best.

Known Compatible Cards

  • Intel AX200, AX201, AX210, AX211
  • Realtek RTL8812AU, RTL8814AU (USB)
  • Atheros AR9271, AR9485
  • MediaTek MT7612U (USB)

Problematic Cards

  • Some Realtek RTL8188CE/RTL8192CE (limited concurrent support)
  • Older Broadcom cards (may need proprietary drivers)

๐Ÿ”ง How It Works

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                    YOUR LAPTOP                          โ”‚
โ”‚                                                         โ”‚
โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”         โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”   โ”‚
โ”‚  โ”‚   WiFi      โ”‚         โ”‚      Hotspot            โ”‚   โ”‚
โ”‚  โ”‚  Client     โ”‚         โ”‚      (AP Mode)          โ”‚   โ”‚
โ”‚  โ”‚ (Managed)   โ”‚         โ”‚                         โ”‚   โ”‚
โ”‚  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜         โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜   โ”‚
โ”‚         โ”‚                            โ”‚                  โ”‚
โ”‚         โ”‚  โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”  โ”‚                  โ”‚
โ”‚         โ””โ”€โ”€โ”ค  NetworkManager      โ”œโ”€โ”€โ”˜                  โ”‚
โ”‚            โ”‚  (Concurrent Mode)   โ”‚                     โ”‚
โ”‚            โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜                     โ”‚
โ”‚                       โ”‚                                 โ”‚
โ”‚            โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”                     โ”‚
โ”‚            โ”‚   NAT / IP Forward   โ”‚                     โ”‚
โ”‚            โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜                     โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                        โ”‚
          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
          โ”‚                           โ”‚
    โ”Œโ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”               โ”Œโ”€โ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”€โ”
    โ”‚  Router   โ”‚               โ”‚  Devices  โ”‚
    โ”‚ (Internet)โ”‚               โ”‚  (Phone,  โ”‚
    โ”‚           โ”‚               โ”‚  Tablet)  โ”‚
    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜               โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
  1. Connects to WiFi as a client (managed mode)
  2. Creates a hotspot access point (AP mode) on the same card
  3. NetworkManager handles the concurrent mode
  4. NAT/IP forwarding shares internet with hotspot clients

๐Ÿ› Troubleshooting

"WiFi connection was lost"

Your WiFi card may not support concurrent mode fully. Try:

  • Different channel (1, 6, or 11 for 2.4GHz)
  • Use a USB WiFi adapter with AP support
  • Check iw phy output

"No WiFi connection active"

You must connect to WiFi before starting the hotspot. This app shares an existing connection.

Hotspot won't start

# Check NetworkManager is running
systemctl status NetworkManager

# Check your WiFi hardware
iw phy

# Try a different interface
hotspot-cli interfaces

Can't connect devices to hotspot

  • Check password is correct
  • Try a different channel (avoid interference)
  • Ensure DHCP is working (restart dnsmasq)

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Development Setup

git clone https://github.com/davytheprogrammer/hotspot-manager.git
cd hotspot-manager
python3 -m venv venv
source venv/bin/activate
pip install -e .
python3 run.py

๐Ÿ“ License

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


๐Ÿ™ Acknowledgments

  • NetworkManager team for concurrent mode support
  • GTK3/GObject developers
  • The Linux wireless community

Made with โค๏ธ by Davis Ogega

Report Bug โ€ข Request Feature

About

๐Ÿ”ฅ Concurrent WiFi + Hotspot Manager for Linux - Share your WiFi connection while staying connected. GTK3 GUI with system tray, CLI, hardware detection, and apt package support.

Topics

Resources

Contributing

Security policy

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages