wifi-qr - GitLite

KO | EN

gitlite — search

#javascript #react #typescript #go #golang #linux #docker #macos #nodejs #windows #cli #vue #pytorch #security

wifi-qr

(★ 135)

Wifi QR code create and scan for linux

파일 탐색기

최종 버전 다운로드 (.zip)

- - format
  - options
- - metadata
  - signing-key.asc
- changelog
- control
- copyright
- install
- manpages
- rules
- watch
- 01_shortcut.png
- 02_main_menu.png
- 03_share_ssid.png
- main.png
- terminal_menu.png
- webcam_selected.png
- webcam_selector.png
.gitignore
COPYING
LICENSE
Makefile
README.KDE.md
README.md
wifi-qr
wifi-qr.1
wifi-qr.desktop
wifi-qr.metainfo.xml
wifi-qr.spec
wifi-qr.svg

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/kokoye2007/wifi-qr

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd wifi-qr

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Make

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# <img src="wifi-qr.svg" width="25" alt="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 |
|----------|-----------|------------|
| ![](https://raw.githubusercontent.com/kokoye2007/wifi-qr/master/screenshots/01_shortcut.png) | ![](https://raw.githubusercontent.com/kokoye2007/wifi-qr/master/screenshots/02_main_menu.png) | ![](https://raw.githubusercontent.com/kokoye2007/wifi-qr/master/screenshots/03_share_ssid.png) |

| Main Menu | Webcam Selector | Webcam Selected |
|-----------|---------------|-----------------|
| ![](https://raw.githubusercontent.com/kokoye2007/wifi-qr/master/screenshots/main.png) | ![](https://raw.githubusercontent.com/kokoye2007/wifi-qr/master/screenshots/webcam_selector.png) | ![](https://raw.githubusercontent.com/kokoye2007/wifi-qr/master/screenshots/webcam_selected.png) |

| Terminal Menu |
|-----------------|
| ![](https://raw.githubusercontent.com/kokoye2007/wifi-qr/master/screenshots/terminal_menu.png) |

## 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](https://github.com/BT-mfasola "Matt") - Array Redesign

[@i-need-to-tell-you-something](https://github.com/i-need-to-tell-you-something "i-need-to-tell-you-something") - Grammar and Typo Fix

[@Pabs3](https://github.com/Pabs3 "Paul Wise") - Shellcheck Recommend

[@Baco](https://github.com/Baco "Dionisio E Alonso") - README update for sudo remove

[@naing2victor](https://github.com/naing2victor "Naing Naing Htun") - Assistant

[@waiyanwinhtain](https://github.com/waiyanwinhtain "wai yan win htain") - Tester and Bug Report

[@hosiet](https://github.com/hosiet "Boyuan Yang") - Mentor and Sponsor for Debian

[@paddatrapper](https://github.com/paddatrapper "Kyle Robbertze") - Mentor and Sponsor for Debian

[@arnabsen1729](https://github.com/arnabsen1729 "Arnab Sen") - QR Scan from File via CLI and GUI

[@sualk](https://github.com/sualk "sualk") - Password with special characters needs to be unquoted

[@ls-1N](https://github.com/ls-1N "ls-1N") - SSID vs Config File Name

[@iandall](https://github.com/iandall "Ian Dall") - qrdata and WPA3-PSK

[@arnelap](https://github.com/arnelap "Arne Lap") - Better keyboard support

[@Thatoo](https://github.com/Thatoo) - QR scan with webcam

[@jabertwo](https://github.com/jabertwo) - Fix english language

[@lamyergeier](https://github.com/lamyergeier) - Installation on Fedora

> [!NOTE]
> Sorry for Code Clean, Rebase and force upload.

> [!TIP]
> [KDE User](./README.KDE.md)

## Installing `wifi-qr` on Fedora via COPR

### Enable the COPR Repository
To get started, enable the COPR repository:

```bash
sudo dnf copr enable kokoye2007/wifi-qr
```

### Install `wifi-qr`
Once the repository is enabled, install the package:

```bash
sudo dnf install wifi-qr
```

## Experimental (v0.4)

- Zenity and Kdialog Option
- RPM, DEB, TGZ support

## Experimental (v0.3-2)

- [#27](/../../issues/27) Better keyboard support
- [#25](/../../issues/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](/../../issues/18) Xiaomi QR code is parsed incorrectly.
- [#17](/../../issues/17) QR issue when the name and SSID differ.
- [#16](/../../issues/16) QR issue when the password has special characters.
- [#15](/../../issues/15) QR issue when the SSID has special characters.
- [#12](/../../issues/12) Password with special characters needs to be unquoted.
  
## v0.1-2 
- [#9](/../../issues/9) shellcheck pass

## v0.1-1 
bash reading replace with nmcli

## Todo list
- [x] QR Generate with GUI
- [x] QR Generate with Terminal 
- [x] QR Scan and Auto Connect
- [x] QR Image File Scan and Auto Connect
- [x] It's Not WiFi QR
- [x] This network is not available. 
- [x] Migration to nmcli
- [x] QR Share Hidden Network
- [x] QR Scan Auto Connect Hidden Network
- [x] icons
- [x] Password with special characters needs to be unquoted
- [x] Scan from Image File
- [x] QR-data
- [x] WPA3-PSK
- [x] 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.

```mermaid
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
```