Simple daemon to create a wifi hotspot on Linux
Python
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
dist updated latest zip Feb 21, 2016
.gitignore updated readme, gitignore May 31, 2017
HISTORY Updated v0.1.7 Mar 1, 2016
LICENSE Initial commit Jul 7, 2014
MANIFEST Created the tar.gz build Dec 29, 2014
README.md updated readme, gitignore May 31, 2017
VERSION Updated v0.1.7 Mar 1, 2016
__init__.py initial commit Jul 8, 2014
cli.py initial commit Jul 8, 2014
hotspotd updated readme, gitignore May 31, 2017
hotspotd.json Updated v0.1.7 Mar 1, 2016
main.py Updated v0.1.7 Mar 1, 2016
run.conf initial commit Jul 8, 2014
run.dat initial commit Jul 8, 2014
setup.py Updated v0.1.7 Mar 1, 2016

README.md

Introduction

Hotspotd is a small daemon to create a wifi hotspot on linux. It depends on hostapd for AP provisioning and dnsmasq to assign IP addresses to devices.

Hotspotd works by creating a virtual NAT (Network address transation) table between your connected device and the internet using linux iptables.

Installation

To install hotspotd, just follow these steps:

wget https://github.com/prahladyeri/hotspotd/raw/master/dist/hotspotd-latest.tar.gz
tar xvf hotspotd-latest.tar.gz
cd hotspotd-latest/
sudo python setup.py install

To uninstall hotspotd, just say:

sudo python setup.py uninstall

Dependencies

  • dnsmasq (typically pre-installed on most linux distributions)
  • hostapd for AP provisioning

To install hostapd on ubuntu:

apt-get install hostapd

Or on RHEL based distros:

yum install hostapd

Usage

To start hotspot:

sudo hotspotd start

To stop hotspot:

sudo hotspotd stop

The first time you run hotspotd, it will ask you for configuration values for SSID, password, etc. Alternatively, you may also run:

sudo hotspotd configure

Troubleshooting

  • Make sure all dependencies (hostapd, dnsmasq and python 2.7) are installed.

  • hotspotd creates the NAT by manipulating iptables rules. So if you have any other firewall software that manipulates the iptables rules (such as the firewalld on fedora), make sure you disable that.

  • To create a hotspot, your wifi must support AP mode. To find that out, use this process:

    • Find your kernel driver module in use by issuing the below command:

      lspci -k | grep -A 3 -i network

      (example module: ath9k)

    • Now, use the below command to find out your wifi capabilities (replace ath9k by your kernel driver):

      modinfo ath9k | grep depend

    • If the above output includes “mac80211” then it means your wifi card will support the AP mode.

Testing status

This package has been tested on Qualcomm Atheros adapter on the following distros:

  • Ubuntu 12.04 LTS
  • Ubuntu 14.04 LTS

In theory, it should work with all other distros too (on machines having wifi adapters supported by hostapd), but you will have to try that out and tell me!

Notes

  • Replace sudo with su or su -c if you manage superuser access in that manner.
  • PyPI home page could be found at https://pypi.python.org/pypi/hotspotd.
  • I need someone to test this daemon across various linux distros. If you are interested in testing of open-source apps, please contact me.