Skip to main content

Library for emulate mouse and keyboard on raspberry pi zero

Project description

HID python library for emulating mouse and keyboard on PI.

Setup

  1. Install apt dependencies
sudo apt-get update
sudo apt-get install -y git python3-full
  1. install usb gadget module
  2. Install zero-hid with pip
pip3 install zero-hid

Usage

Note: You should connect the data usb port (left one) to the raspberry, and NOT the power port

  • Control mouse
from zero_hid import Mouse
m = Mouse()
for i in range(5):
    m.move(10, 10)
  • Control keyboard
from zero_hid import Keyboard

k = Keyboard()
k.type('Hello world!')

Features

  • Relative / Absolute mouse movements
  • Left / Right / Middle click
  • Scrolling
  • Typing
  • Hot keys
  • Drag and Drop
  • Easy to setup
  • Comprehensive Testing

Examples

see examples

Tests

Raspberry Pi Model Raspbian Version Kernel Version
Raspberry Pi 4 Raspbian 12 6.1
Raspberry Pi Zero Raspbian 5.10 -

Gotaches

Error when installing with pip

error: externally-managed-environment

See how-solve-error-externally-managed-environment-when-installing-pip3

Or simply execute

sudo rm -rf /usr/lib/python3.11/EXTERNALLY-MANAGED

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zero-hid-0.1.6.tar.gz (30.6 kB view hashes)

Uploaded Source

Built Distribution

zero_hid-0.1.6-py3-none-any.whl (45.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page