72 lines
1.9 KiB
Markdown
72 lines
1.9 KiB
Markdown
# Pico Rubber Ducky
|
|
|
|
## 🦆 Introduction
|
|
|
|
This is a USB Rubber Ducky project made with the Raspberry Pi Pico! It types commands and chords (keypresses that activate stuff, like `Ctrl+Alt+T`) at superhuman speeds, allowing you to execute keypresses *really* fast.
|
|
|
|
This project uses the C programming language, the Pico SDK, gcc, cmake, and make. **Development has been tested on Debian Trixie only and its successful development or usage on Windows is not guaranteed**.
|
|
|
|
It was tested on the RP2040 version of the Pico W. Due to not using any Pico-W exclusive features, it will very likely work on the original Pico.
|
|
|
|
## 🛠️ Usage
|
|
|
|
On Debian, run:
|
|
|
|
```
|
|
sudo apt update
|
|
sudo apt install cmake gcc-arm-none-eabi libnewlib-arm-none-eabi build-essential libstdc++-arm-none-eabi-newlib
|
|
```
|
|
|
|
Clone the repository:
|
|
|
|
```
|
|
git clone <your-repo-url>
|
|
cd pico_rubber_ducky
|
|
```
|
|
|
|
Get the Pico SDK.
|
|
|
|
- If you have it, set an environment variable pointing to it:
|
|
```
|
|
export PICO_SDK_PATH=/path/to/their/pico-sdk
|
|
```
|
|
- If not, clone it to the project folder:
|
|
```
|
|
git clone -b master https://github.com/raspberrypi/pico-sdk.git
|
|
cd pico-sdk
|
|
git submodule update --init
|
|
cd ..
|
|
export PICO_SDK_PATH=$(pwd)/pico-sdk
|
|
```
|
|
|
|
Build the dependencies and environment:
|
|
|
|
```
|
|
cmake .
|
|
```
|
|
|
|
Build the `.uf2` file:
|
|
|
|
```
|
|
make
|
|
```
|
|
|
|
Now you can plug a Raspberry Pi Pico/Pico W on BOOTSEL mode and drag the finished `.uf2` file into it.
|
|
|
|
> [!TIP]
|
|
> If you don't want my test chord and string running, **IMMEDIATELY** unplug the raspberry pi once it has finished transferring.
|
|
|
|
## 🎁 Customization
|
|
|
|
Open `main.c` and go to line 168, where you can see several test functions. These are the chords and strings to be executed.
|
|
|
|
To execute a chord: `type_chord("ctrl+alt+t");`
|
|
|
|
To execute a string: `type_string("hello!");`
|
|
|
|
## 🏅 Credits
|
|
|
|
P7MJ original.
|
|
|
|
> [!WARNING]
|
|
> I do not endorse using this for malicious purposes! This is a test project ONLY. |