Skip to content

Latest commit

 

History

History
209 lines (133 loc) · 6.17 KB

README.md

File metadata and controls

209 lines (133 loc) · 6.17 KB
Raw

WiFi-QR Logo WiFi-QR

WiFi Share and Connect with QR

Xiaomi Android phones has started using QR to use WiFi for sharing.

The idea was to get started with Bash, from Android to PC or PC to

Mobile, and use Interface for zenity, QR for zbar and qrencode,

and nmcli from Network-Manager for Network. For security,

you can use WPA, WPA2, WEP, Open and share with the Hidden Network.

QR code does not support LDAP Network and VPN.

Android can easily generate WiFi QR, iOS via Shortcuts apps.

Screenshot

Shortcut Main Menu Share SSID
Main Menu Webcam Selector Webcam Selected
Terminal Menu

Usage

Generate WIFI QR

It's easy to generate QR codes for WiFi networks by check and generate WPA, WEP, Open, and even HIDDEN networks using nmcli.

You can generate QR codes using:

  • Command line:

    • wifi-qr -t to launch WiFi QR creation from the terminal.
    • wifi-qr -c to launch WiFi QR creation using a GUI.
    • wifi-qr -z to use the terminal with a fuzzy finder for network selection.

  • Graphical interface:

    • wifi-qr -g to launch the main menu GUI for various operations including QR generation.

Scan and Connect with QR Code

Functioning like an Android QR scanner, this allows scanning and automatically connecting to networks. iOS users can see the password but need to manually connect.

You can scan and connect using:

  • Command line:

    • wifi-qr -s for scanning a QR and auto-connecting to WiFi.
    • wifi-qr -f [file] to scan a QR from a file and auto-connect to WiFi.

  • Graphical interface:

    • wifi-qr -p to launch a GUI for scanning a QR from a file and connecting to WiFi.
    • wifi-qr -q to scan and connect to WiFi directly from the GUI.

Webcam Selector

Select and configure a webcam for use with WiFi QR operations. This option will allow you to use your webcam to scan WiFi QR codes directly.

  • Command line:
    • wifi-qr -w to select and configure your webcam for scanning QR codes.

Additional Commands

  • wifi-qr -L Use legacy (backslash) encoding/decoding.
  • wifi-qr -v Display the version of WiFi-QR (Version 0.3).
  • wifi-qr -h Show the help message.

Contributor

@BT-mfasola - Array Redesign

@i-need-to-tell-you-something - Grammar and Typo Fix

@Pabs3 - Shellcheck Recommend

@Baco - README update for sudo remove

@naing2victor - Assistant

@waiyanwinhtain - Tester and Bug Report

@hosiet - Mentor and Sponsor for Debian

@paddatrapper - Mentor and Sponsor for Debian

@arnabsen1729 - QR Scan from File via CLI and GUI

@sualk - Password with special characters needs to be unquoted

@ls-1N - SSID vs Config File Name

@iandall - qrdata and WPA3-PSK

@arnelap - Better keyboard support

@Thatoo - QR scan with webcam

@jabertwo - Fix english language

Note

Sorry for Code Clean, Rebase and force upload.

Tip

KDE User

Experimental (v0.3-2)

  • #27 Better keyboard support
  • #25 QR scan with webcam
  • Applied ShellCheck recommendations for improved script quality.
  • Fix outdated NetworkManager keyfile docs; migrate to nmcli. (LP: #2019939)
  • Adds metainfo.xml file for AppStream integration.

v0-3-1

  • #18 Xiaomi QR code is parsed incorrectly.
  • #17 QR issue when the name and SSID differ.
  • #16 QR issue when the password has special characters.
  • #15 QR issue when the SSID has special characters.
  • #12 Password with special characters needs to be unquoted.

v0.1-2

  • #9 shellcheck pass

v0.1-1

bash reading replace with nmcli

Todo list

  • QR Generate with GUI
  • QR Generate with Terminal
  • QR Scan and Auto Connect
  • QR Image File Scan and Auto Connect
  • It's Not WiFi QR
  • This network is not available.
  • Migration to nmcli
  • QR Share Hidden Network
  • QR Scan Auto Connect Hidden Network
  • icons
  • Password with special characters needs to be unquoted
  • Scan from Image File
  • QR-data
  • WPA3-PSK
  • Webcam Selector
  • Additional LDAP Login
  • Kdialog with KDE

Improve

LDAP and LEAP We will come back when QR Code and Scanner support LDAP and relative thing.

nmcli c add type wifi con-name <connect name> ifname wlan0 ssid <ssid>
nmcli con modify <connect name> wifi-sec.key-mgmt wpa-psk
nmcli con modify <connect name> wifi-sec.psk <password> 
nmcli con up <connect name>

UML diagrams

WIFI QR UML.

graph TD
    T[Terminal / GUI] --> S[QR Scanner]
    T --> Q[QR Creator]
    
    %% Scanner Branch
    S --> W[Webcam]
    S --> F[QR File]
    
    W --> P[Process QR]
    F --> P
   
    P --> WIFI[Connect WIFI]
    
    %% Creator Branch
    Q --> CURRENT_SSID[Current SSID]
    Q --> SSID_LIST[SSID List]
    SSID_LIST --> GEN[Generate QR]
    CURRENT_SSID --> GEN
    GEN --> PNG[QR PNG File]
    
    %% Styling
    classDef process fill:#f9f,stroke:#333,stroke-width:2px
    classDef input fill:#bbf,stroke:#333,stroke-width:2px
    class W,F,SSID_LIST,CURRENT_SSID input
    class P,GEN process
Loading