Skip to content

pardus/pardus-hotspot

Repository files navigation

Pardus Hotspot

License

🇹🇷 | 🇬🇧

Introduction

Pardus Hotspot is a Linux application that helps you easily create and manage a Wi-Fi hotspot on your computer. With its simple interface, you can quickly set up and share your internet connection with other devices.

Features

  • User-friendly interface
  • Support for both 2.4GHz and 5GHz frequency bands
  • WPA2 (WPA-PSK) and WPA3 (SAE) security protocols
  • QR code generation for easy connection sharing
  • System tray integration
  • Automatic configuration saving
  • Autostart capability

Installation

Requirements

Before installing Pardus Hotspot, ensure your system meets the following requirements:

  • network-manager: The application relies on NetworkManager for managing network connections.
  • python3: Pardus Hotspot is built with Python 3
  • python3-dbus: Required for the application to interact with NetworkManager.
  • libgtk-3-dev & libglib2.0-dev: Required for the graphical interface.
  • gir1.2-ayatanaappindicator3-0.1: Used for creating a system tray icon.
  • python3-gi: Allows Python to use GTK and GNOME libraries.
  • gir1.2-gtk-3.0: Provides the library for building windows and buttons.
  • gir1.2-gdkpixbuf-2.0: Enables showing images, like QR codes.
  • python3-qrcode: Used to create QR codes.
  • python3-pil / python3-pillow: Helps handle images needed for QR codes.

Usage

  • From Package Manager
    sudo apt install pardus-hotspot
  • From Source
    # Clone the repository
    git clone https://github.com/pardus/pardus-hotspot
    
    # Navigate to the project directory
    cd pardus-hotspot
    
    # Install dependencies
    sudo apt install network-manager python3 python3-dbus libgtk-3-dev libglib2.0-dev \
        gir1.2-ayatanaappindicator3-0.1 python3-gi gir1.2-gtk-3.0 \
        gir1.2-gdkpixbuf-2.0 python3-qrcode python3-pil
    
    # Run the application
    python3 Main.py
    
    

Usage Guide

Creating a Hotspot
  1. Launch the application
  2. Enter a connection name (SSID)
  3. Set a password (minimum 8 characters)
  4. Select your wireless interface (interfaces are detected automatically)
  5. Click to "Create Hotspot"
Advanced Settings
  • Band Selection: Choose between 2.4GHz and 5GHz bands
  • Security Protocol: Select WPA2 (WPA-PSK) or WPA3 (SAE).
  • Autostart: Enable/disable automatic startup with system

Notes: - For Apple products, select SAE for the encryption method. If the connection isn't visible on other devices, try switching to WPA-PSK - Due to Linux limitations, 2.4GHz mode is recommended

QR Code Sharing

Once the hotspot is active, a scannable QR code automatically appears for easy connection sharing with mobile devices.

Interface

  • Application interface for active/inactive connection states:

Hotspot Disabled Hotspot Enabled

  • Settings configuration:

Hotspot Settings

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •