Skip to content

Commit 8fae727

Browse files
committed
docs: 📝 add readme for flipper catalog
1 parent 7779849 commit 8fae727

1 file changed

Lines changed: 49 additions & 0 deletions

File tree

README_CATALOG.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
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

Comments
 (0)