[ English ] | 简体中文

DShare-HID is a high-performance, open-source project derived from Deskflow. While sharing the core architecture, DShare-HID is an independent fork focused on sharing keyboard and mouse inputs with mobile devices including iPad, iPhone, and Android phones.

While traditional software KVM solutions like Deskflow work great between computers, they cannot support mobile platforms like iPadOS or Android. DShare-HID bridges this gap by extending Deskflow's capabilities to these devices:

• iOS and Android do not allow background apps to intercept or simulate system-wide HID (Human Interface Device) events for security reasons.
• Apple Sidecar/Universal Control is restricted to the Apple ecosystem, leaving Windows and Linux users behind.
• Remote Desktop solutions often suffer from high latency and depend on network stability, which can impact fluid, real-time peripheral sharing.

DShare-HID uses a budget-friendly (~$2.50 USD on AliExpress) ESP32-C3 Supermini board as a hardware bridge. It converts Deskflow events into Bluetooth Low Energy (BLE) HID, letting you wirelessly share your keyboard and mouse with any mobile device.

_{Image credit: Josselin Hefti}

Main UI	Device Configuration

• Native Experience: No apps or drivers are required on the target device. It sees a standard Bluetooth peripheral.
• Ultra-Low Latency: Offers superior responsiveness compared to remote screen sharing solutions.
• Universal Compatibility: Fully supports Windows, macOS, and Linux hosts. Compatible with official upstream Deskflow clients.
• Multi-Device Pairing: Securely pair and toggle between up to 6 mobile devices. Switching is instantaneous and effortless.
• US Layout & International Flexibility: Acts as a standard US layout keyboard but supports native iOS/Android "Hardware Keyboard" settings for non-US mappings.
• Consumer Key Support: Dedicated control for media keys, including Play/Pause and Volume.
• Native External Display: Use your tablet as a high-quality secondary screen.

We provide pre-built binaries for all major platforms. Choose the one that fits your environment.

Suitable for macOS 12+ (Intel & Apple Silicon).

This option is currently disabled and will be supported in a future update.

1. Download the latest .dmg from the Releases page.
2. Open dshare-hid-1.26.0-macos-universal.dmg and drag the application to your Applications folder.
3. Note: If you encounter a "Damaged" or "Unverified" error, run the following command in Terminal:

   xattr -cr /Applications/DShare-HID.app

Dependency: Please ensure you have installed Microsoft Visual C++ Redistributable v14.44 or later before use.

Available as a portable archive (Recommended) or installer.

• Portable (.7z): Recommended. Extract and run dshare-hid.exe.
• Installer (.msi): Download and double-click to install.

We support major distributions via AppImage and Flatpak.

sudo usermod -a -G dialout $USER

Works on newer Linux distributions (Ubuntu 22.04+, Fedora 36+, etc.).

1. Download the .AppImage file from Releases.
2. Make it executable:

   chmod +x dshare-hid-1.26.0-linux-x86_64.AppImage

3. Run it:

   ./dshare-hid-1.26.0-linux-x86_64.AppImage

Please download the .flatpak file from our Releases page and install it locally.

1. Setup Flatpak If you haven't used Flatpak before, ensure it is installed and the Flathub repository is added:

# Debian/Ubuntu
sudo apt install flatpak

# Fedora
sudo dnf install flatpak

# Arch Linux
sudo pacman -S flatpak

# Add Flathub Repo (All Distros)
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

2. Install

flatpak install --user ./dshare-hid-1.26.0-linux-x86_64.flatpak

# Uninstall
flatpak uninstall io.github.lockekk.dshare-hid

# Reinstall (Remove then Install)
flatpak uninstall io.github.lockekk.dshare-hid
flatpak install --user ./dshare-hid-1.26.0-linux-x86_64.flatpak

For Ubuntu 24.04 and newer.

1. Download the .deb file from Releases.
2. Install:

   sudo apt install ./dshare-hid_1.26.0_ubuntu_24.04_amd64.deb

3. Uninstall:

   sudo apt remove dshare-hid

You will need an ESP32-C3 Supermini board. These are cheap and widely available from AliExpress or local electronics stores. Connect it to your computer via USB.

Open DShare-HID and navigate to File -> Firmware to open the management interface.

For a brand new "virgin" device, follow this sequence:

1. Factory Mode (Online):

   • Go to the Factory Mode tab.
   • Click Flash under the "Online" section to install the generic factory firmware.
   • This prepares the device for pairing and licensing.

2. Request per-device application:

   • Go to the Order tab.
   • Choose Request 7-Day Free Trial or Purchase Full License.
   • Fill in your details and click Email to send the request.
   • You will receive a specific per-device firmware file (e.g., app_xxxx.uzip) via email.

3. Install Application (Manual):

   • Go to the Upgrade Mode tab.
   • Under "Manual", browse and select the file you received.
   • Click Flash to install your licensed firmware.

• Upgrading: Go to the Upgrade Mode tab and click Check for Updates -> Flash to install the latest features via OTA.
• Activation: Go to the Activation tab to view your license status or input a new activation key.

The development environment and build process for DShare-HID are identical to the upstream Deskflow project. You can follow the official build instructions for Windows, macOS, and Linux.

Note: The firmware flashing and authentication modules are optional components and not part of the core open-source project. Users are welcome to build and use their own custom firmware implementation.

DShare-HID is an open-source project at its core. The desktop application and bridge architecture are open for contribution and community improvement.

• 7-Day Full Trial: Experience the full functionality of the firmware and software for 7 days at no cost.
• Lifetime Value: After the trial, a one-time activation provides lifetime free upgrades via OTA and lifetime maintenance.

Special thanks to the Deskflow project and its contributors. This project is built upon their strong foundation.

We also thank Josselin Hefti for the excellent 3D model image of the ESP32-C3 Supermini.

• Email: dshare.hid@gmail.com
• Issues: Please report bugs via GitHub Issues.

DShare-HID is an open-source project. However, some optional features (like firmware management) may rely on proprietary components. The core application remains fully functional and open-source without these components.

DShare-HID is licensed under the GNU General Public License v2.0 (GPL-2.0-only). This project is a derivative work based on Deskflow.