linux-wifi-hotspot/README.md

## Linux Wifi Hotspot

[![Build Status](https://travis-ci.com/lakinduakash/linux-wifi-hotspot.svg?branch=master)](https://travis-ci.com/lakinduakash/linux-wifi-hotspot)
[![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)


### 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 and share connection with 2.4GHz.
* Select Channel.
* Hide SSID

![screenshot](docs/sc2.png)

[Command line help and documentation](src/scripts/README.md)

### 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

#### For building from source

* cmake (https://cmake.org)
* make
* gcc and g++
* build-essential
* pkg-config
* gtk
* 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
```




## Installation

    git clone https://github.com/lakinduakash/linux-wifi-hotspot
    cd linux-wifi-hotspot
    
    #build binaries
    make
    
    #install
    sudo make install
    
    
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.
    
    
## Uninstallation
    sudo make uninstall
    
## Running
Run in terminal
 `wihotspot`
    
Tested with Ubuntu 18.10. 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

Copyright (c) 2013, oblique

Copyright (c) 2019, lakinduakash