{"id":17816973,"url":"https://github.com/thewh1teagle/zero-hid","last_synced_at":"2025-04-13T00:45:29.622Z","repository":{"id":112644975,"uuid":"421952557","full_name":"thewh1teagle/zero-hid","owner":"thewh1teagle","description":"Raspberry pi virtual HID mouse and keyboard","archived":false,"fork":false,"pushed_at":"2025-02-17T20:17:07.000Z","size":144,"stargazers_count":112,"open_issues_count":7,"forks_count":26,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-04T05:41:53.483Z","etag":null,"topics":["hid","mouse","python","raspberry-pi","usb"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/zero-hid","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thewh1teagle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-27T19:44:37.000Z","updated_at":"2025-04-03T20:07:15.000Z","dependencies_parsed_at":"2024-05-08T20:23:52.008Z","dependency_job_id":"190ff436-e259-4d3d-b29c-ec49d4b03eba","html_url":"https://github.com/thewh1teagle/zero-hid","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewh1teagle%2Fzero-hid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewh1teagle%2Fzero-hid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewh1teagle%2Fzero-hid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thewh1teagle%2Fzero-hid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thewh1teagle","download_url":"https://codeload.github.com/thewh1teagle/zero-hid/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248650420,"owners_count":21139672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hid","mouse","python","raspberry-pi","usb"],"created_at":"2024-10-27T16:39:55.843Z","updated_at":"2025-04-13T00:45:29.601Z","avatar_url":"https://github.com/thewh1teagle.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\u003cimg width=550 src=\"https://github.com/thewh1teagle/zero-hid/assets/61390950/13608efd-15c1-4fdd-86b5-e411e15fa638\"\u003e\n\nHID python library for emulating mouse and keyboard on PI.\n\n\n## Setup\n\n1. Install apt dependencies\n\n```console\nsudo apt-get update\nsudo apt-get install -y git python3-pip python3-venv\n```  \n\n2. install [usb gadget module](https://github.com/thewh1teagle/zero-hid/tree/main/usb_gadget#usb-gadget-module-configuration-for-zero-hid)\n\n3. Create virtual environment\n\n```console\npython3 -m venv ~/venv\nsource ~/venv/bin/activate\n```\n\n4. Install `zero-hid` with `pip`\n```console\npip3 install zero-hid\n```\n5. Reboot *if not already!*\n\n## Usage\nNote: You should connect the data usb port (left one) to the raspberry, and **NOT** the power port  \n  \n- Control mouse\n```python\nfrom zero_hid import Mouse\nm = Mouse()\nfor i in range(5):\n    m.move(10, 10)\n```\n- Control keyboard\n```python\nfrom zero_hid import Keyboard\n\nk = Keyboard()\nk.type('Hello world!')\n```\n\n## Features\n- Relative / Absolute mouse movements\n- Left / Right / Middle click\n- Scrolling\n- Typing\n- Hot keys\n- Drag and Drop\n- LEDs status\n- Easy to setup\n- Comprehensive Testing\n\n## Examples\nsee [examples](examples)\n\n## Tests\n\n| Raspberry Pi Model | Raspbian Version      | Kernel Version | Date of Testing |\n|--------------------|-----------------------|----------------|-----------------|\n| Raspberry Pi 4     | Raspbian 12 (bookworm)| 6.6.31         | 04/08/2024      |\n| Raspberry Pi 4     | Raspbian 12           | 6.1            | 01/01/2023      |\n| Raspberry Pi Zero  | Raspbian 5.10         | -              | 01/01/2023      |\n\n## Gotchas\n\n---\nAbsolute mouse used only for positioning - use relative mouse for clicking, etc. See examples.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthewh1teagle%2Fzero-hid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthewh1teagle%2Fzero-hid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthewh1teagle%2Fzero-hid/lists"}