Package to manage wifi hotspot on linux
Project description
Introduction
============
*PyAccessPoint* is a package to create a wifi access point on linux. Itdepends on *hostapd* for AP provisioning and *dnsmasq* to assign IP addresses to devices.
Dependencies
============
So, there 2 types of dependencies.
System dependencies:
- dnsmasq
- hostapd
- python3
Python dependencies
- wireless
- netifaces
- psutil
You can not install python dependencies manually, they will be installed while installing the package.
If you want to do it manually, just type (or copy, it's better way :D)
::
sudo apt install python3-dev python3-pip && sudo pip3 install wireless netifaces psutil
Installation
============
Easy way by using pip
::
sudo apt update && sudo apt --yes --force-yes install dnsmasq hostapd python3-dev python3-pip && sudo pip3 install pyaccesspoint
Hard way
1. Install system dependencies
::
sudo apt update && sudo apt --yes --force-yes install dnsmasq hostapd python3-dev unzip python3-pip
2. Download latest package
::
cd ~ && wget --output-document=pyaccesspoint-master.zip https://github.com/Goblenus/pyaccesspoint/archive/master.zip
3. Unpack downloaded package
::
unzip pyaccesspoint-master.zip && cd pyaccesspoint-master
4. Install it
::
sudo python3 setup.py install
5. Remove files
::
cd ~ && sudo rm -rf pyaccesspoint-master.zip pyaccesspoint-master
That is all. Now you can use PyAccessPoint.
One line install:
::
sudo apt update && sudo apt --yes --force-yes install dnsmasq hostapd python3-dev unzip python3-pip && cd ~ && wget --output-document=pyaccesspoint-master.zip https://github.com/Goblenus/pyaccesspoint/archive/master.zip && unzip pyaccesspoint-master.zip && cd pyaccesspoint-master && sudo python3 setup.py install && cd ~ && sudo rm -rf pyaccesspoint-master.zip pyaccesspoint-master
Usage
=====
You can use it as standalone command line utility:
To start
::
sudo pyaccesspoint start
It will create hotspot named "MyAccessPoint" on wlan0 with "1234567890" password.
All arguments you may obtain by typing:
::
pyaccesspoint --help
To stop
::
sudo pyaccesspoint stop
You can configure and save config file. This will save you time at them next start
::
sudo pyaccesspoint configure
You config file file will be placed at /etc/accesspoint/accesspoint.json.
To start it with config file just type:
::
sudo pyaccesspoint --config start
Tested
======
- OrangePi Plus with Armbian 5.23
Note
====
This project is python3 compatible only, python2 is not tested at all.
Idea
====
This project is fork of https://github.com/prahladyeri/hotspotd (Prahlad Yeri - prahladyeri@yahoo.com)
============
*PyAccessPoint* is a package to create a wifi access point on linux. Itdepends on *hostapd* for AP provisioning and *dnsmasq* to assign IP addresses to devices.
Dependencies
============
So, there 2 types of dependencies.
System dependencies:
- dnsmasq
- hostapd
- python3
Python dependencies
- wireless
- netifaces
- psutil
You can not install python dependencies manually, they will be installed while installing the package.
If you want to do it manually, just type (or copy, it's better way :D)
::
sudo apt install python3-dev python3-pip && sudo pip3 install wireless netifaces psutil
Installation
============
Easy way by using pip
::
sudo apt update && sudo apt --yes --force-yes install dnsmasq hostapd python3-dev python3-pip && sudo pip3 install pyaccesspoint
Hard way
1. Install system dependencies
::
sudo apt update && sudo apt --yes --force-yes install dnsmasq hostapd python3-dev unzip python3-pip
2. Download latest package
::
cd ~ && wget --output-document=pyaccesspoint-master.zip https://github.com/Goblenus/pyaccesspoint/archive/master.zip
3. Unpack downloaded package
::
unzip pyaccesspoint-master.zip && cd pyaccesspoint-master
4. Install it
::
sudo python3 setup.py install
5. Remove files
::
cd ~ && sudo rm -rf pyaccesspoint-master.zip pyaccesspoint-master
That is all. Now you can use PyAccessPoint.
One line install:
::
sudo apt update && sudo apt --yes --force-yes install dnsmasq hostapd python3-dev unzip python3-pip && cd ~ && wget --output-document=pyaccesspoint-master.zip https://github.com/Goblenus/pyaccesspoint/archive/master.zip && unzip pyaccesspoint-master.zip && cd pyaccesspoint-master && sudo python3 setup.py install && cd ~ && sudo rm -rf pyaccesspoint-master.zip pyaccesspoint-master
Usage
=====
You can use it as standalone command line utility:
To start
::
sudo pyaccesspoint start
It will create hotspot named "MyAccessPoint" on wlan0 with "1234567890" password.
All arguments you may obtain by typing:
::
pyaccesspoint --help
To stop
::
sudo pyaccesspoint stop
You can configure and save config file. This will save you time at them next start
::
sudo pyaccesspoint configure
You config file file will be placed at /etc/accesspoint/accesspoint.json.
To start it with config file just type:
::
sudo pyaccesspoint --config start
Tested
======
- OrangePi Plus with Armbian 5.23
Note
====
This project is python3 compatible only, python2 is not tested at all.
Idea
====
This project is fork of https://github.com/prahladyeri/hotspotd (Prahlad Yeri - prahladyeri@yahoo.com)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
PyAccessPoint-0.2.1.tar.gz
(6.8 kB
view hashes)