ESP32 BLE Keyboard

external_components:
  - source:
      type: git
      url: https://github.com/markusg1234/ESPHome-espidf_ble_keyboard
      ref: main  # or pin a release tag, e.g. v1.0.0
    components: [ espidf_ble_keyboard ]

espidf_ble_keyboard:
  id: my_keyboard
  device_name: "ESP32 BLE KB"  # optional, max 29 chars
  key_delay_ms: 80  # optional, increase if characters drop
  passkey: 123456  # optional 6-digit PIN
  passkey_mode: legacy  # use secure_connections for iOS (required)
  web_control: true  # optional, built-in web UI
  api_services: true  # optional, auto-register HA services (needs api:) — cards work without yaml snippets
  host_slots: 4  # optional, multi-host switching (1–10)
  mouse_sensitivity: 1.0  # optional, web mouse base speed (default: 1.0)
  mouse_acceleration: 0.15  # optional, web mouse accel factor (default: 0.15)
  mouse_max_speed: 4.0  # optional, web mouse max sensitivity (default: 4.0)
  scroll_sensitivity: 2.0  # optional, web mouse scroll speed (default: 2.0)
  screen_width: 3840   # optional, desktop px for mouse_abs_px / mouse_goto
  screen_height: 2160  # optional
  mouse_goto_scale_x: 0.57  # optional, mouse_goto X calibration (tune in Position Finder; saved per host)
  mouse_goto_scale_y: 0.57  # optional, mouse_goto Y calibration
  monitors:            # optional, multi-monitor — mark the Windows primary
    - { name: main, x: 0, y: 0, width: 3840, height: 2160, primary: true }
  keyboard_layout: us  # optional, us | uk | de | be — must match host PC layout (default: us)
  custom_text_id:        # optional, link text entities for Send buttons
    - custom_text

button:
  - platform: espidf_ble_keyboard
    keyboard_id: my_keyboard
    name: "Win + R"
    action: "combo:0x08:0x15"

  - platform: espidf_ble_keyboard
    keyboard_id: my_keyboard
    name: "Shutdown PC"
    action: "shutdown"

binary_sensor:
  - platform: espidf_ble_keyboard
    keyboard_id: my_keyboard
    name: "BLE Keyboard Paired"

# ON  = GAP pairing completed successfully on current connection
# OFF = disconnected/unpaired, or no successful pairing yet in this session

sensor:
  # RSSI — signal strength of connected host
  - platform: espidf_ble_keyboard
    keyboard_id: my_keyboard
    name: "BLE Host RSSI"
    update_interval: 10s
  # Active Host — publishes current host slot (0-based)
  # Required for keyboard card host switcher to stay in sync
  - platform: espidf_ble_keyboard
    keyboard_id: my_keyboard
    type: active_host
    name: "BLE Keyboard Active Host"

type: custom:ble-mouse-card
device: bluetooth_keyboard
name: Mouse Control        # optional card title
sensitivity: 1.5            # optional cursor speed (default: 1.5)
mouse_acceleration: 0.15   # optional acceleration factor (default: 0.15)
mouse_max_speed: 4.5       # optional max sensitivity cap (default: 4.5)
scroll_sensitivity: 2      # optional scroll speed (default: 2)
tap_to_click: true          # optional tap = left click (default: true)

type: custom:ble-keyboard-card
device: bluetooth_keyboard
name: BLE Keyboard          # optional card title
show_fkeys: true            # optional show F1-F12 row (default: true)
host_slots: 4              # optional host switcher (default: 0 = hidden)
host_names:                  # optional custom names per slot
  - TV
  - Phone

type: custom:ble-remote-card
device: bluetooth_keyboard
name: Media Remote           # optional card title (auto from HA if omitted)
show_numpad: true            # optional number pad (default: false)
show_apps: true              # optional app launch row (default: true)
show_color: true             # optional color buttons (default: false)

api:
  services:
    # Mouse card services
    - service: mouse_move
      variables:
        x: int
        y: int
      then:
        - lambda: |-
            id(my_keyboard).send_mouse_move(x, y);
    - service: mouse_scroll
      variables:
        amount: int
      then:
        - lambda: |-
            id(my_keyboard).send_mouse_scroll(amount);
    - service: mouse_click
      variables:
        btn: int
      then:
        - lambda: |-
            id(my_keyboard).send_mouse_click(btn);
    - service: mouse_hold          # press & hold for dragging — release with mouse_release
      variables:
        btn: int
      then:
        - lambda: |-
            id(my_keyboard).send_mouse_click_start(btn);
    - service: mouse_release
      then:
        - lambda: |-
            id(my_keyboard).send_mouse_click_release();
    - service: mouse_abs          # move cursor to exact position, % of screen
      variables:
        x: float
        y: float
      then:
        - lambda: |-
            id(my_keyboard).execute_action("mouse_abs:" + to_string(x) + ":" + to_string(y));
    # Keyboard card services
    - service: send_string
      variables:
        keys: string
      then:
        - lambda: |-
            id(my_keyboard).send_string(keys);
    - service: send_key
      variables:
        modifier: int
        keycode: int
      then:
        - lambda: |-
            id(my_keyboard).send_key_combo(modifier, keycode);
    # Remote card service
    - service: send_consumer
      variables:
        code: int
      then:
        - lambda: |-
            id(my_keyboard).send_consumer(code);
    # Host switching service
    - service: switch_host
      variables:
        slot: int
      then:
        - lambda: |-
            id(my_keyboard).switch_host(slot);