aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: 02572f989198b77b9156fee6fef9288c2285be73 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
# 🛰️ Orion RF (WIP)

**Orion RF** is a portable RF & wireless experimentation toolkit built for the ESP32 platform with NRF24 support.

> ⚠️ This project is currently under active development. Some features are experimental, incomplete, or may change frequently.

---

# 🚀 Current Features

## 📡 Wireless Tools

### BLE Scan
- Discover nearby Bluetooth Low Energy devices
- View MAC address, RSSI, and device information
- Real-time scanning interface

### WiFi Scan
- Scan nearby WiFi access points
- View:
  - SSID
  - Signal strength (RSSI)
  - Channel
  - Encryption type

### WiFi Analyzer
- Analyze surrounding WiFi activity
- Useful for understanding channel congestion and wireless environments

### RF Capture *(WIP)*
- Experimental RF packet capture functionality
- Replay support planned

---

# 📻 NRF24 Tools

### BLE Jammer
- NRF24-based BLE interference testing
- Functional

### Bluetooth Jammer
- NRF24-based Bluetooth interference testing
- Functional

### WiFi Jammer
- NRF24-based WiFi interference testing
- Experimental

> ⚠️ These tools are intended strictly for wireless research, testing, and educational purposes in authorized environments.

---

# ⌨️ BadUSB

- HID keyboard emulation
- Execute automated payloads/scripts
- Useful for testing and automation workflows

---

# 🖱️ BLE Mouse

- ESP32-based Bluetooth mouse emulation
- Experimental HID functionality

---

# 🔧 System Utilities

### System Info
- Display device/system information
- Useful for debugging and diagnostics

### Device Check
- Verify connected peripherals/modules
- Hardware diagnostics utility

### Restart
- Quick device reboot option from UI

---

# 🧩 Project Status

| Feature              | Status            |
| -------------------- | ----------------- |
| BLE Scan             | ✅ Working        |
| WiFi Scan            | ✅ Working        |
| WiFi Analyzer        | ✅ Working        |
| BadUSB               | ✅ Working        |
| BLE Mouse            | ✅ Working        |
| BLE Jammer           | ✅ Working        |
| Bluetooth Jammer     | ✅ Working        |
| WiFi Jammer          | ⚠️ Experimental   |
| RF Capture           | 🚧 WIP            |
| RF Replay            | 🚧 WIP            |
| SD Card Support      | 🚧 Planned        |
| Emulator             | 🚧 Planned        |
| NFC                  | 🚧 Planned        |

---

# 🛠️ Hardware

- 1 x ESP32-S3
- 2 x NRF24L01 Modules
- 2 x CC1101 Modules
- 1 x OLED Display
- Battery-powered portable setup

---

# 📌 Notes

- Designed primarily for learning, experimentation, and embedded RF research
- Optimized for portable usage
- UI-driven navigation system

---

# ⚖️ Disclaimer

This project is intended for:
- Educational purposes
- RF experimentation
- Hardware research
- Authorized security testing

The authors are not responsible for misuse or illegal operation of this project.