SSH HID Client

Android app that allows you to use your phone as a wireless keyboard
(adapter not included)

Table of Contents

1. About The Project
2. Getting Started
   • Prerequisites
3. Usage
4. Roadmap
5. License
6. Acknowledgments

About The Project

This Android app allows your phone to connect via SSH to a gadget which presents itself as a keyboard. Since this happens at a very low level, the connected device sees it exactly as a normal keyboard, meaning you don't need to install any software on the connected computer! For this reason, it will even work if the connected device is in its BIOS/UEFI. Even multimedia keys are supported, meaning you can send volume up/down keys to the connected computer to control media.

(back to top)

Getting Started

Prerequisites

• Any device running Android
• SSH access to a Linux device acting as an USB HID gadget
• Soft Keyboard, for example Unexpected Keyboard

Installation (Binary)

Obtain via Obtanium!

Deep link which GitHub refuses to render as clickable:

obtainium://add/https://github.com/AlexanderPavlenko/android-hid-client

Verification info:

• Package ID: top.flvr.ssh_hid_client
• SHA-256 of the signing certificate: A9:38:D4:A9:02:5A:C1:4A:7B:89:CC:FF:7A:EB:A3:9D:C3:21:43:84:5D:C9:7B:68:4E:A4:01:92:81:2A:46:BC

Installation (Source)

Clone the repository.

git clone --depth 1 https://github.com/AlexanderPavlenko/android-hid-client.git

import into Android Studio, build the APK, then install it on your Android device.

(back to top)

Usage

To relay keys in real-time as soon as you press them, click on the keyboard icon in the menu bar. It should pull up your keyboard. Now you can just start typing!

Typing in the "Manual Input" text box will send all the characters that you've typed into the box to the connected device once you hit the "send" button.

(back to top)

Roadmap

• Keyboard support
• Add some special key buttons to the UI (like multimedia keys)
• Touchpad support removed
• Ability to send string all at once
• Add full settings page

See the open issues for a full list of proposed features (and known issues).

(back to top)

License

Distributed under the GNU GPLv3 License. See LICENSE.txt for more information.

(back to top)

Acknowledgments

• Original USB HID Client

(back to top)