Nixyri/linux-wifi-hotspot
1
0
Fork 0
mirror of https://github.com/lakinduakash/linux-wifi-hotspot.git synced 2024-11-10 06:00:11 +00:00
Code Issues Packages Projects Releases Wiki Activity
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).
457 Commits 8 Branches 39 Tags 2.1 MiB
C 44.6%
Shell 42.6%
C++ 6.7%
Makefile 3.6%
CMake 2%
Other 0.5%
4ae6ded863
Go to file
Lakindu Akash 4ae6ded863
Merge pull request #204 from lakinduakash/dev 
Remove using namespace std; in qrgen.cpp
2021-10-19 00:48:15 +05:30
.github Update build.yml 2021-10-18 05:58:54 +05:30
debian Fix permission error when listing devices 2021-10-18 04:57:16 +05:30
docs Update screenshots README 2021-10-18 05:15:52 +05:30
src Remove using namespace std; in qrgen.cpp 2021-10-19 00:45:10 +05:30
util/debian Create Dockerfile for building Deb package 2020-10-22 00:19:09 -07:00
.coveralls.yml Create .coveralls.yml 2019-04-20 08:42:17 +05:30
.gitignore Add about dialog 2021-02-20 08:23:41 +05:30
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2019-04-19 00:53:08 +05:30
CONTRIBUTING.md Update CONTRIBUTING.md 2020-10-13 16:40:37 +05:30
LICENSE Update Licence 2021-02-20 08:21:54 +05:30
Makefile Support cli only installation 2020-12-22 20:28:36 +05:30
Makefile.cmake Rename old Makfile to compatible with cmake 2020-10-04 15:53:45 +05:30
README.md Update screenshots README 2021-10-18 05:15:52 +05:30

README.md

Linux Wifi Hotspot

Build Gitter FOSSA Status

Update

  • Share wifi via QR code
  • UI improvements
  • Fallback to same channel when same wifi interface does not support for multiple channels
  • Show the connected devices
  • Add MAC filter

Features

  • Share your wifi like in Windows - Use wifi and enable hotspot at the same time.
  • Share access point from any network interface
  • MAC filter
  • 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.
  • Select Channel.
  • Hide SSID
  • Show the connected devices

screenshot

Command line help and documentation

Read Command line help and documentation here.

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

Notes

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

If any problems with RealTeK Wifi Adapters see this

Installation

Debian/Ubuntu

Download the debian package from latest release

OR

sudo add-apt-repository ppa:lakinduakash/lwh
sudo apt install linux-wifi-hotspot

Arch based distributions

Install with:

yay -S 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,

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

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

Run on Startup

The wihotspot GUI uses create_ap to create and manage access points. This service and core logic was originally created by @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 make open source world more beautiful. Please read CONTRIBUTING.md for more info.

Disclaimer

Icons made by Freepik from www.flaticon.com

License

FreeBSD

Copyright (c) 2013, oblique

Copyright (c) 2021, lakinduakash

FOSSA Status