linux-wifi-hotspot

mirror of https://github.com/lakinduakash/linux-wifi-hotspot.git synced 2024-11-24 21:20:12 +00:00

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).

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

Go to file

Lakindu Akash 678e5e839e Fix circleci yml		2020-10-04 16:50:24 +05:30
.circleci	Fix circleci yml	2020-10-04 16:50:24 +05:30
.github	Update blank.yml	2020-08-25 02:42:38 +05:30
docs	Add new screenshot	2019-04-18 00:55:47 +05:30
src	Remove unwanted files	2020-10-04 15:54:03 +05:30
.coveralls.yml	Create .coveralls.yml	2019-04-20 08:42:17 +05:30
.gitignore	Update gitignore	2019-04-14 21:08:24 +05:30
.travis.yml	Update ci/cd files	2020-10-04 16:37:49 +05:30
CODE_OF_CONDUCT.md	Create CODE_OF_CONDUCT.md	2019-04-19 00:53:08 +05:30
CONTRIBUTING.md	Update CONTRIBUTING.md	2019-04-19 01:01:44 +05:30
LICENSE	Update LICENSE	2020-03-16 14:37:38 +05:30
Makefile	Transfer build system from cmake to make	2020-10-04 15:52:25 +05:30
Makefile.cmake	Rename old Makfile to compatible with cmake	2020-10-04 15:53:45 +05:30
README.md	Update README.md with new install instruction	2020-10-04 16:17:55 +05:30
snapcraft.yaml	add snapcraft	2019-04-24 14:46:20 +05:30

README.md

Linux Wifi Hotspot

Update

Config files are wriiten to /etc/wh.config (Previously, configurations were wriiten to home directory as .wh.config).
.desktop file is added. So You can start from app launcher
Use make to build instead of cmake

Features

Share your wifi like in Windows - Share wifi on same interface which you are connected to internet.
Share access point from any network interface
Includes Both command line and gui.
Support both 2.4GHz and 5GHz (Need to compatible with your wifi adapter). Ex: You have connected to 5GHz network and share connection with 2.4GHz.
Select Channel.
Hide SSID

Command line help and documentation

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

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

dnsmasq
iptables

To build from source

make
gcc and g++
build-essential
pkg-config
gtk
libgtk-3-dev

On Ubuntu or debian install dependencies by,

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

Installation

Note: If you have installed previous version of this project make sure to uninstall it by checking out to the previous version (v2.1.1 or below). Also you can use sudo make clean-old without checking out to the previous version. After that install the binaries. Otherwise your system might left orphaned binaries and files.

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

#build binaries
make

#install
sudo make install

Uninstallation

sudo make uninstall

To build with cmake (Deprecated)

You need additionally cmake Use the Makefile.cmake

cd linux-wifi-hotspot
#Build binaries
make -f Makefile.cmake

#Install
sudo make -f Makefile.cmake install

#Uninstall
sudo make -f Makefile.cmake uninstall

Running

You can run it from terminal or from application menu.

Run in terminal wihotspot

Tested with Ubuntu from 16.04 to 20.04. If any issue found, file a issue on github.

credits - oblique

Contributing

This project is still new. So you can simply open a issue and send a PR. Also there are some existing issues. Pick one and start contributing.

License

FreeBSD