Nixyri/linux-wifi-hotspot
1
0
Fork 0
mirror of https://github.com/lakinduakash/linux-wifi-hotspot.git synced 2024-11-24 21:20:12 +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).
286 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%
9fb8f53754
Go to file
Christian Lewis 9fb8f53754 Cleaned up README; added note about enabling service
2020-11-08 19:07:14 -06:00
.circleci Fix circleci yml 2020-10-04 17:13:38 +05:30
.github Create .stale.yml 2020-10-03 18:23:00 +05:30
debian Update debian version 2020-10-31 00:47:22 +05:30
docs Update screenshots 2020-10-31 00:45:45 +05:30
src Use /etc/wh.config for create_ap service. 2020-11-08 17:56:11 -06:00
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 Update .gitignore 2020-10-04 17:50:44 +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 2020-10-13 16:40:37 +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 Cleaned up README; added note about enabling service 2020-11-08 19:07:14 -06:00
snapcraft.yaml add snapcraft 2019-04-24 14:46:20 +05:30

README.md

Linux Wifi Hotspot

Build Status Gitter

Update

  • Add MAC filter
  • Release Debian package

Features

  • Share your wifi like in Windows - Share wifi on the same interface which you are connected to on the internet.
  • 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

screenshot

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

Installation

Debian/Ubuntu

Download the debian package from latest release

Arch based distributions

Install with:

yay -Sy 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

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 the previous version of this project make sure to uninstall it by checking out the previous version (v2.1.1 or below). Also you can use sudo make clean-old without checking out the previous version. After that install the binaries. Otherwise your system might leave 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

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

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

Contributing

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

License

FreeBSD

Copyright (c) 2013, oblique

Copyright (c) 2020, lakinduakash