2019-04-14 16:43:50 +00:00
|
|
|
## Linux Wifi Hotspot
|
|
|
|
|
2019-04-17 20:19:58 +00:00
|
|
|
[![Build Status](https://travis-ci.com/lakinduakash/linux-wifi-hotspot.svg?branch=master)](https://travis-ci.com/lakinduakash/linux-wifi-hotspot)
|
2019-04-17 20:52:12 +00:00
|
|
|
[![Gitter](https://badges.gitter.im/linux-wihotspot/community.svg)](https://gitter.im/linux-wihotspot/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
|
|
|
|
[![HitCount](http://hits.dwyl.io/lakinduakash/linux-wifi-hotspot.svg)](http://hits.dwyl.io/lakinduakash/linux-wifi-hotspot)
|
|
|
|
|
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
|
|
|
![screenshot](docs/sc2.png)
|
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-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
|
|
|
|
sudo apt install -y libgtk-3-dev build-essential cmake gcc g++ pkg-config make
|
|
|
|
```
|
|
|
|
|
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
|
|
|
|
|
|
|
## License
|
|
|
|
FreeBSD
|
|
|
|
|
|
|
|
Copyright (c) 2013, oblique
|
|
|
|
|
|
|
|
Copyright (c) 2019, lakinduakash
|