2019-04-14 16:43:50 +00:00
## Linux Wifi Hotspot
2019-04-17 20:19:58 +00:00
[](https://travis-ci.com/lakinduakash/linux-wifi-hotspot)
2019-04-17 20:52:12 +00:00
[](https://gitter.im/linux-wihotspot/community?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge)
2019-04-17 20:19:58 +00:00
2019-04-14 16:43:50 +00:00
### Features
2019-04-15 21:30:14 +00:00
2019-04-16 21:14:18 +00:00
* Share your wifi like in Windows - Share wifi on same interface which you are connected to internet.
* Share access point from any network interface
2019-04-15 21:30:14 +00:00
* 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 and share connection with 2.4GHz.
2019-04-17 21:14:17 +00:00
* Select Channel.
* Hide SSID
2019-04-14 16:43:50 +00:00
2019-04-17 19:36:57 +00:00
2019-04-17 18:32:30 +00:00
2019-04-17 18:13:41 +00:00
[Command line help and documentation ](src/scripts/README.md )
2019-04-17 18:12:59 +00:00
2019-05-27 21:15:43 +00:00
### Notes
2019-09-02 04:25:48 +00:00
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.
2019-05-27 21:15:43 +00:00
2019-09-05 12:02:41 +00:00
If any problems with **RealTeK Wifi Adapters** see [this ](docs/howto/realtek.md )
2019-09-05 12:01:16 +00:00
2019-04-16 21:00:39 +00:00
### Dependencies
2019-04-14 16:43:50 +00:00
2019-04-16 21:00:39 +00:00
#### General
2019-04-16 21:14:18 +00:00
* bash
2019-04-16 21:00:39 +00:00
* 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)
2019-04-14 16:44:26 +00:00
2019-04-16 21:14:18 +00:00
_Make sure you have those dependencies by typing them in terminal. If any of dependencies fail
install it using your distro's package manager_
2019-04-16 21:00:39 +00:00
#### For 'NATed' or 'None' Internet sharing method
* dnsmasq
* iptables
#### For building from source
2019-04-14 16:44:26 +00:00
2019-04-16 21:14:18 +00:00
* cmake (https://cmake.org)
2019-04-16 21:00:39 +00:00
* make
2019-04-15 21:30:14 +00:00
* gcc and g++
2019-04-16 21:00:39 +00:00
* build-essential
* pkg-config
* gtk
2019-04-17 20:32:12 +00:00
* libgtk-3-dev
On Ubuntu or debian install dependencies by,
```bash
2019-07-02 08:21:19 +00:00
sudo apt install -y libgtk-3-dev build-essential cmake gcc g++ pkg-config make hostapd
2019-04-17 20:32:12 +00:00
```
2019-04-16 21:00:39 +00:00
## Installation
2019-04-17 20:32:12 +00:00
2019-04-16 21:00:39 +00:00
git clone https://github.com/lakinduakash/linux-wifi-hotspot
cd linux-wifi-hotspot
2019-04-17 20:32:12 +00:00
#build binaries
2019-04-16 21:00:39 +00:00
make
2019-04-17 20:32:12 +00:00
#install
2019-04-16 21:00:39 +00:00
sudo make install
2019-04-17 21:19:58 +00:00
If you don't want to install it to system, you can run programm from build directory. Then you don't want to run `sudo make install` .
But make sure `create_ap` the command line util is installed.
2019-04-17 18:12:59 +00:00
2019-04-16 21:00:39 +00:00
## Uninstallation
2019-04-16 21:14:18 +00:00
sudo make uninstall
2019-04-17 14:43:24 +00:00
## Running
2019-04-17 18:33:41 +00:00
Run in terminal
2019-04-17 14:43:24 +00:00
`wihotspot`
2019-04-16 21:17:39 +00:00
Tested with Ubuntu 18.10. If any issue found, file a issue on github.
2019-04-16 21:14:18 +00:00
2019-04-16 21:17:39 +00:00
**credits** - oblique
2019-04-17 18:18:17 +00:00
2019-04-18 07:00:07 +00:00
## Contributing
2019-04-18 07:03:14 +00:00
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.
2019-04-18 07:00:07 +00:00
2019-04-17 18:18:17 +00:00
## License
FreeBSD
Copyright (c) 2013, oblique
Copyright (c) 2019, lakinduakash
