f0-usb-keyboard-bt-proxy

FlipperZero USB Keyboard BT Proxy

– Why???

– IDK.

But in reality, I had a mini-PC to configure, a laptop and no external keyboard.

Table of Contents

• About
  • GUI
  • FAP
• Installation
  • GUI
  • FAP
• Usage

About

Laptop –> Bluetooth (BLE) –> FlipperZero –> USB (HID) –> Device.

Stability/usability is questionable at this moment.

GUI

Requires python >= 3.10.

Should work on MacOS (tested), Linux (not tested), Windows (not tested).

PySide6 used for bluetooth client. It's fat and an overkill, but my experience with Bleak was unsatisfactory.

PySDL2 is used to capture keyboard events. They map almost as is to HID.

FAP

This repository helped to figure stuff out.

Installation

GUI

pip install f0-usb-keyboard-bt-proxy

FAP

Build from source:

git clone https://github.com/tzoiker/flipperzero-usb-keyboard-bt-proxy.git
cd flipperzero-usb-keyboard-bt-proxy/fap
pip install ufbt

Optionally, select desirable firmware version, e.g.,

ufbt update -b 1.0.1

and, then, after connecting F0,

ufbt launch

Otherwise,

• download .fap file from the releases (may not be compatible with your version of firmware);
• place it to the SD-card under apps/Bluetooth.

Usage

1. Connect your F0 to the device you need a keyboard for.
2. Open the USB Keyboard BT Proxy application on F0.
3. Press Start. It will show BT device name, e.g., UsbKbBtP <F0 name>.
4. Enable bluetooth on your computer.
5. Run f0-usb-keyboard-bt-proxy --device-bt-name="UsbKbBtP <F0 name>".
6. Now you can type in the opened window, and it will, hopefully, work.