https://github.com/retr0kr0dy/beamstalker
BeamStalker is open-source firmware for esp based board designed for RF experimentation, encouraging collaboration and ethical exploration.
https://github.com/retr0kr0dy/beamstalker
esp32 firmware hacking m5cardputer microcontroller radio rf
Last synced: 10 months ago
JSON representation
BeamStalker is open-source firmware for esp based board designed for RF experimentation, encouraging collaboration and ethical exploration.
- Host: GitHub
- URL: https://github.com/retr0kr0dy/beamstalker
- Owner: Retr0Kr0dy
- License: wtfpl
- Created: 2024-11-13T19:09:14.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-08T11:58:26.000Z (about 1 year ago)
- Last Synced: 2025-05-08T12:41:48.838Z (about 1 year ago)
- Topics: esp32, firmware, hacking, m5cardputer, microcontroller, radio, rf
- Language: C
- Homepage: https://retr0kr0dy.github.io/BeamStalker/
- Size: 49.6 MB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
BeamStalker is open-source firmware for esp based boards designed for RF experimentation, encouraging collaboration and ethical exploration. No profit motive here—just a project for those who want to mess around with RF tech and hack their way through.
Open-source means you can poke around, modify, and make it your own. It’s all about collaboration and sharing your findings with the community. Explore, experiment, and push boundaries, but keep it ethical—don’t bring any malicious nonsense into it.
Join in, share your findings, and let’s see what we can create together. Happy hacking!
##### Knowledge should be free 🏴☠️
## Installation
Currently you have two choices, either you get the latest bin file for you board in the [release section](https://github.com/Retr0Kr0dy/BeamStalker/releases) and flash it to your board, or you can build the project from source using esp-idf v4.4 (see [Get Started](https://retr0kr0dy.github.io/BeamStalker/Setup.html)).
> [!NOTE]
> Work gracefully with the [M5Launcher project](https://github.com/bmorcelli/M5Stick-Launcher).
## Usage
You got 3 main way to control the firmware :
- Main one, using custom gpio, you will need to have a board with button, but it's the intend way of usage.
- Second one, is using the main button on esp (short press, long press, ...) but it's currently buggy.
- Third one, is using the serial console, but this imply that you have a phone or computer nearby to control.
For more specific usage docs, go check the [wiki](https://retr0kr0dy.github.io/BeamStalker).
## Features
|Type|Name|Description|Status|
|-|-|-|-|
|Wifi|BeaconSpam|Spam nearby client with dumb wifi AP|Fully implemented|
|Wifi|Deauther|Spam either boadcast, or targeted client with deauth frame|Fully implemented|
|Wifi|WifiSniffer|Sniff 802.11 frame accroding to a given filter|Fully Implemented|
|BLE|BleSpam|Spam nearby client with ble adv frames|Fully implemented|
|RF|RecordReplay|Record and replay subghz frame|To do|
|RF|TPMS|Forge and patch tpms frame|To do|
## Supported boards
- [esp32](https://www.espressif.com/en/products/socs/esp32)
- [esp32s3](https://www.espressif.com/en/products/socs/esp32s3)
- [M5Cardputer](https://shop.m5stack.com/products/m5stack-cardputer-kit-w-m5stamps3)
- [HeltecV3](https://heltec.org/project/wifi-lora-32-v3/)
---
*Made with fun by akpalanaza*