Skip to content

DavidMGilbert/MouseJack-RF-Nano

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MouseJack-RF-Nano

⚠ PLEASE NOTE: This code is only for educational purposes. ⚠

⚠ If you do something illegal expect to be held responsible for your own actions. ⚠

📑 Introduction

MouseJack-RF-Nano is a project, based on uC_mousejeck by insecuritythings, to get Mousejack attacks into a small embedded device, with the form factor of a key chain.

Building the device is straight-forward, and the code provides a tool to use Duckyscript to launch automated keystroke injection attacks against Microsoft and Logitech devices.

🛒 Shopping List

👨🏻‍💻 How to get started?

Compiling & Upload

To build the software, download and install the PlatformIO IDE.

Before building the software, be sure to modify the attack.h file using the attack_generator.py script:

MouseJack-RF-Nano $ cd tools
tools $ ./attack_generator.py ducky.txt

In the example above, the ducky.txt file contains our Duckyscript. The attack_generator.py script will "compile" the ducky script into the attack.h file, which is included in main.cpp. This simplifies the code and makes it more compact.

Testing

Once you power the device on, the internal LED connected to pin 13 (called ledpin in the code), will blink two times for each pass over the entire channel range. When it sends an attack, the LED will glow solid.

If you monitor the serial port using the PlatformIO IDE, you will see the radio information details and a lot of debugging information being printed while scanning and during attack.

Warning: No interaction is required to initiate an attack.

📝 How to Contribute?

  • Take a look at the Existing Issues or create your own Issues!
  • Wait for the Issue to be assigned to you after which you can start working on it.
  • Fork the Repo and create a Branch for any Issue that you are working upon.
  • Create a Pull Request which will be promptly reviewed and suggestions would be added to improve it.
  • Share your wins and your fails when trying this out!

✨ Contributors ✨

Contributions of any kind welcome!

Project Admin

Happy Hacking 👨‍💻