Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lakinduakash/linux-wifi-hotspot

Feature-rich wifi hotspot creator for Linux which provides both GUI and command-line interface. It is also able to create a hotspot using the same wifi card which is connected to an AP already ( Similar to Windows 10).
https://github.com/lakinduakash/linux-wifi-hotspot

archlinux gtk3 gui hacktoberfest internet linux linux-wifi-hotspot network shell-script ubuntu wifi wifi-adapter wifi-hotspot

Last synced: about 1 month ago
JSON representation

Feature-rich wifi hotspot creator for Linux which provides both GUI and command-line interface. It is also able to create a hotspot using the same wifi card which is connected to an AP already ( Similar to Windows 10).

Awesome Lists containing this project

README 

        
## Linux Wifi Hotspot



![Build](https://github.com/lakinduakash/linux-wifi-hotspot/actions/workflows/build.yml/badge.svg)



[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Flakinduakash%2Flinux-wifi-hotspot.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Flakinduakash%2Flinux-wifi-hotspot?ref=badge_shield)



### What's new

* Use aa-complain instead of complain to fix the permission issue for dnsmasq

* Fix some 5Ghz band not working issue

* Compatible with iw 6.7



#### Thank you for all the contributions made while I was not active on this repository.



### Features



* Share your wifi like in Windows - Use wifi and enable hotspot at the same time.

* Share a wifi access point from any network interface

* [Create a hotspot with VPN](#vpn-hotspot) - The hotspot has the traffic tunnelled through VPN. Useful for devices with no VPN app support like TV or gaming consoles.

* Share wifi via QR code

* MAC filter

* View connected devices

* Includes Both command line and GUI.

* Support both 2.4GHz and 5GHz (Need to be compatible with your wifi adapter). Ex: You have connected to the 5GHz network and share a connection with 2.4GHz.

* Customise wifi Channel, Change MAC address, etc.

* Hide SSID

* customize gateway IP address

* Enable IEEE 80211n, IEEE 80211ac and IEEE 80211ax modes



![screenshot](docs/sc4.png)



### Command line help and documentation



Read [Command line help and documentation here](src/scripts/README.md).



If you only need the command line without GUI run `make install-cli-only` as the root user.



### Notes



- Sometimes there are troubles with **5Ghz bands** due to some vendor restrictions. If you cannot start the hotspot while you are connected to the 5Ghz band, Unselect **Auto** and select **2.4Ghz** in frequency selection.



- If any problems with **RealTeK Wifi Adapters** see [this](docs/howto/realtek.md)



- **Unable to allocate IP: firewalld issue:** Please check for potential fixes: [#209](https://github.com/lakinduakash/linux-wifi-hotspot/issues/209) [#166](https://github.com/lakinduakash/linux-wifi-hotspot/issues/166)



## Installation



#### Debian/Ubuntu



Download the Debian package from the latest [release](https://github.com/lakinduakash/linux-wifi-hotspot/releases/latest)



**OR**

Good news! I was able to restore keys, new versions will be available via the PPA

```bash

sudo add-apt-repository ppa:lakinduakash/lwh

sudo apt update

sudo apt install linux-wifi-hotspot



```



#### Arch based distributions



Linux Wifi Hotspot is available as an [AUR package](https://aur.archlinux.org/packages/linux-wifi-hotspot/). You can install it manually or with your favorite AUR helper.

For example, if you use `yay` you can do:

`yay -S linux-wifi-hotspot`



### Fedora based distributions

copr based repo is available for Fedora 

```bash

sudo dnf copr enable zinix01/linux-wifi-hotspot

sudo dnf install linux-wifi-hotspot 

```



## Dependencies



#### General

* bash

* util-linux (for getopt)

* procps or procps-ng

* hostapd

* iproute2

* iw

* iwconfig (you only need this if 'iw' can not recognize your adapter)

* haveged (optional)



_Make sure you have those dependencies by typing them in terminal. If any of dependencies fail

install it using your distro's package manager_



#### For 'NATed' or 'None' Internet sharing method

* dnsmasq

* iptables



#### To build from source



* make

* gcc and g++

* build-essential

* pkg-config

* gtk

* libgtk-3-dev

* libqrencode-dev (for qr code generation)

* libpng-dev (for qr code generation)



On Ubuntu or Debian install dependencies by,



```bash

sudo apt install -y libgtk-3-dev build-essential gcc g++ pkg-config make hostapd libqrencode-dev libpng-dev

```



On Fedora/CentOS/Red Hat Enterprise Linux/Rocky Linux/Oracle Linux

```bash

sudo dnf install -y gtk3-devel gcc gcc-c++ kernel-devel pkg-config make hostapd qrencode-devel libpng-devel

```



## Installation



    git clone https://github.com/lakinduakash/linux-wifi-hotspot

    cd linux-wifi-hotspot



    #build binaries

    make



    #install

    sudo make install



## Uninstallation

    sudo make uninstall



## Running

You can launch the GUI by searching for "Wifi Hotspot" in the Application Menu

or using the terminal with:



    wihotspot



Create VPN Hotspot



After connecting to VPN, Open `wihotspot` GUI. Select the virtual interface created by the VPN. In this case it is `tun0`



![image](docs/vpn.png)



## Run on Startup

The `wihotspot` GUI uses `create_ap` to create and manage access points. This service and core logic were originally created by

[@oblique](http://github.com/oblique), and are now maintained in this

repository.



Start the hotspot service on startup (using your saved configuration) with:



    systemctl enable create_ap



## Contributing



If you found a bug or you have an idea about improving this make an issue. Even a small contribution makes the open source world more beautiful.

Please read [CONTRIBUTING.md](CONTRIBUTING.md) for more info.



## Disclaimer

Icons made by Freepik from www.flaticon.com




## Stargazers over time



[![Stargazers over time](https://starchart.cc/lakinduakash/linux-wifi-hotspot.svg)](https://starchart.cc/lakinduakash/linux-wifi-hotspot)



## License

FreeBSD



Copyright (c) 2013, oblique



Copyright (c) 2024, lakinduakash



[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Flakinduakash%2Flinux-wifi-hotspot.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Flakinduakash%2Flinux-wifi-hotspot?ref=badge_large)