Home

Awesome

Linux Wifi Hotspot

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

Build

<!--[![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) -->

FOSSA Status

What's new

Thank you for all the contributions made while I was not active on this repository.

Features

screenshot

Command line help and documentation

Read Command line help and documentation here.

If you only need the command line without GUI run make install-cli-only as the root user.

Notes

Installation

Debian/Ubuntu

Download the Debian package from the latest release

OR Good news! I was able to restore keys, new versions will be available via the PPA

sudo add-apt-repository ppa:lakinduakash/lwh
sudo apt update
sudo apt install linux-wifi-hotspot

Arch based distributions

Linux Wifi Hotspot is available as an AUR package. You can install it manually or with your favorite AUR helper. For example, if you use yay you can do: yay -S linux-wifi-hotspot

Fedora based distributions

copr based repo is available for Fedora

sudo dnf copr enable zinix01/linux-wifi-hotspot
sudo dnf install linux-wifi-hotspot 

Dependencies

General

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

To build from source

On Ubuntu or Debian install dependencies by,

sudo apt install -y libgtk-3-dev build-essential gcc g++ pkg-config make hostapd libqrencode-dev libpng-dev

On Fedora/CentOS/Red Hat Enterprise Linux/Rocky Linux/Oracle Linux

sudo dnf install -y gtk3-devel gcc gcc-c++ kernel-devel pkg-config make hostapd qrencode-devel libpng-devel

Installation

git clone https://github.com/lakinduakash/linux-wifi-hotspot
cd linux-wifi-hotspot

#build binaries
make

#install
sudo make install

Uninstallation

sudo make uninstall

Running

You can launch the GUI by searching for "Wifi Hotspot" in the Application Menu or using the terminal with:

wihotspot
<h2 id="vpn-hotspot">Create VPN Hotspot</h2>

After connecting to VPN, Open wihotspot GUI. Select the virtual interface created by the VPN. In this case it is tun0

image

Run on Startup

The wihotspot GUI uses create_ap to create and manage access points. This service and core logic were originally created by @oblique, and are now maintained in this repository.

Start the hotspot service on startup (using your saved configuration) with:

systemctl enable create_ap

Contributing

If you found a bug or you have an idea about improving this make an issue. Even a small contribution makes the open source world more beautiful. Please read CONTRIBUTING.md for more info.

Disclaimer

<div>Icons made by <a href="https://www.freepik.com" title="Freepik">Freepik</a> from <a href="https://www.flaticon.com/" title="Flaticon">www.flaticon.com</a></div>

Stargazers over time

Stargazers over time

License

FreeBSD

Copyright (c) 2013, oblique

Copyright (c) 2024, lakinduakash

FOSSA Status