linux-wifi-hotspot/README.md
2019-05-28 02:45:43 +05:30

2.6 KiB

Linux Wifi Hotspot

Build Status Gitter HitCount

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

Command line help and documentation

Notes

Sometimes there are troubles with 5Ghz due to some vendor restriction. If you cannot start hotspot while you are connected to 5Ghz band, Unselect Auto and select 2.4Ghz in frequency selection.

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,

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