|
| 1 | +# InfraFi |
| 2 | + |
| 3 | +Transmit WiFi credentials from a **Flipper Zero** to a **Linux server** using infrared. Point, press Send, connected. |
| 4 | + |
| 5 | +Built for headless servers (NAS boxes, Intel NUCs, etc.) where typing WiFi passwords is painful or impossible. |
| 6 | + |
| 7 | +## How It Works |
| 8 | + |
| 9 | +The Flipper encodes WiFi credentials as a sequence of **RC-6 IR messages** and blasts them at the server's CIR (Consumer IR) receiver. The daemon decodes the transmission and connects to the network automatically. No pairing, no Bluetooth, no network required — just line-of-sight IR. |
| 10 | + |
| 11 | +With **ACK enabled**, the daemon transmits a response back via IR — the Flipper displays whether the connection succeeded (with IP address) or failed. |
| 12 | + |
| 13 | +## Features |
| 14 | + |
| 15 | +- **Manual entry** — On-screen keyboard for SSID and password, security type selector (Open/WPA/WEP/SAE) |
| 16 | +- **NFC WiFi tags** — Scan an NTAG213/215/216 tag with WiFi credentials and transmit instantly |
| 17 | +- **Saved networks** — Credentials auto-save to SD card after transmit. Browse, resend, or delete |
| 18 | +- **Fast transmission** — Full credentials sent in under a second via RC-6 protocol |
| 19 | +- **Hidden network support** — Toggle hidden SSID flag |
| 20 | +- **ACK feedback** — Optional. When enabled in Settings, the Flipper waits for a response from the server. Shows "Connected! IP: x.x.x.x" or "Failed" on screen |
| 21 | + |
| 22 | +## Requirements |
| 23 | + |
| 24 | +- A Linux server with an IR receiver (tested with ITE8708 CIR in Intel NUCs) |
| 25 | +- The **infrafid** daemon running on the server — see [GitHub](https://github.com/amd989/InfraFi) for install instructions |
| 26 | +- Pre-built .deb and .rpm packages available from [GitHub Releases](https://github.com/amd989/InfraFi/releases) |
| 27 | + |
| 28 | +## Usage |
| 29 | + |
| 30 | +**Manual Entry:** |
| 31 | +1. Open **InfraFi** on your Flipper |
| 32 | +2. Select **Send Credentials** |
| 33 | +3. Enter SSID, password, and security type |
| 34 | +4. Review on the confirm screen, press **Send** |
| 35 | +5. Point the Flipper at the server's IR receiver |
| 36 | + |
| 37 | +**NFC Tag:** |
| 38 | +1. Write WiFi credentials to an NFC tag using a phone app (e.g., **NFC Tools**) |
| 39 | +2. Open **InfraFi** — **Scan NFC Tag** |
| 40 | +3. Hold the tag to the back of the Flipper |
| 41 | +4. Review credentials, press **Send** |
| 42 | + |
| 43 | +**Saved Networks:** |
| 44 | +- Previously transmitted networks are auto-saved to the SD card |
| 45 | +- Open **InfraFi** — **Saved** to browse and resend |
| 46 | + |
| 47 | +## Author |
| 48 | + |
| 49 | +**Alejandro Mora** — [github.com/amd989](https://github.com/amd989) |
0 commit comments