Skip to content

Share your Raspberry's WiFi to Ethernet

License

Notifications You must be signed in to change notification settings

davegabe/PiLanshare

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

68 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GramThanos version dev-version

PiLanshare

Share your Raspberry's WiFi to Ethernet

PiLanshare


Setup

Install from the web

Install pre-release v0.3.3-beta PiLanshare Daemon and WebUI

wget https://raw.githubusercontent.com/davegabe/PiLanshare/v0.3.3-beta/install.py
sudo apt install python3-distutils
sudo python3 ./install.py -v
rm ./install.py

The default installation paths are, for the daemon /etc/pilanshare and for the WebUI /var/www/html/pilanshare. The installation script does not install or configure any webserver. Tested on a Raspberry Pi 3B with Raspberry Pi OS (32-bit).

You can also download the ieee oui data, so that the WebUI can find the vendor name from the MAC address

sudo wget -O /var/www/html/pilanshare/includes/oui.txt http://standards-oui.ieee.org/oui/oui.txt
sudo chown root:www-data /var/www/html/pilanshare/includes/oui.txt

Install by clonning the git repo

Install latest development version of PiLanshare Daemon and WebUI

sudo apt install python3-distutils
sudo apt install git
git clone https://github.com/davegabe/PiLanshare.git
cd ./PiLanshare
sudo python3 ./install.py -v

Connect to the WebUI

The WebUI is accessible at http://<Raspberry IP>/pilanshare/ (using credentials created during installation). To check the Raspberry's IP address, you can use the hostname -I command.

Configuration

Apart from the WebUI configuration, you can configure the PiLanshare daemon by creating a pilanshare.ini file at your Raspberry's boot partition (located at /boot/).

Example pilanshare.ini

[DAEMON]
log_level = info

[IPTABLES]
enable = True
interface_source = wlan0
interface_target = eth0
ip_address = 192.168.3.1
netmask = 255.255.255.0

[DNSMASQ]
enable = True
interface = eth0
dhcp_start = 192.168.3.20
dhcp_end = 192.168.3.255
dhcp_netmask = 255.255.255.0
dhcp_broadcast = 192.168.3.255
dhcp_lease_time = 12h
router_ip_address = 192.168.3.1
router_domain_name = pilanshare.local

[DNSMASQ_BINDS]
00:01:02:03:04:05 = 192.168.3.10
02:04:06:08:0A:0C = 192.168.3.11

More Images

preview image - login page preview image - dashboard page preview image - lanshare page preview image - devices page preview image - queries page preview image - net stats page preview image - system page


What's next?

  • Improve installation script
    • Implement WebUI installation

Contribute to the project

Leave your feedback or to express your thoughts!

You can open an issue or send me a mail


Powered By

This project was made possible by:

Raspberry Pi, Qnsmasq, iptables, Python, PHP, Bootstrap, jQuery, Bootbox, DataTables, Font Awesome, Chart.js, Quicksand Font


License

This project is under The MIT license. I do although appreciate attribution. The libraries used on the WebUI page have their own licenses.

Copyright (c) 2020 Grammatopoulos Athanasios-Vasileios


GramThanos

About

Share your Raspberry's WiFi to Ethernet

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 47.5%
  • Python 33.8%
  • JavaScript 17.3%
  • CSS 1.4%