KWarp emulates a HID device (keyboard) and sends the text it receives via Bluetooth as keystrokes to the connected computer. It helps sending passwords managed by a password manager from mobile to a computer that doesn't have direct access to the manager.
The hardware used by this project is T-Display-S3. It's an esp32s3 development board with a display. Check out their repo for more information.
- Install Visual Studio Code and Python
- Search for the
PlatformIOplugin in theVisualStudioCodeextension and install it. - After the installation is complete, you need to restart
VisualStudioCode - After restarting
VisualStudioCode, selectFilein the upper left corner ofVisualStudioCode->Open Folder-> select thekwarpdirectory - Wait for the installation of third-party dependent libraries to complete
- Click the (✔) symbol in the lower left corner to compile
- Connect the board to the computer USB
- Click (→) to upload firmware
- Install nRF Connect on mobile.
- Plug in the board to a target computer. On its screen it should show a device name and a PIN.
- Open the installed nRF Connect for Mobile application on the phone.
- Scan and find the board and connect. It should prompt for a PIN for pairing.
- After pairing, in the clinet tab, click on the write/upload icon and send the passwords as text.
- Tap send, and the device should type these characters into the connected computer.
- PlatformIO no longer finds my development board after I run the project.
- KWarp uses the USB port to emulate a keyboard. PlatformIO cannot write to the device when it's running. Press Boot and then RST and release them to put the device into development mode and PlatformIO should see it again. Press RST again after writting the program to the board.