{"id":20448069,"url":"https://github.com/xingrz/zmkx-sdk","last_synced_at":"2025-04-13T01:13:39.900Z","repository":{"id":175233325,"uuid":"652887625","full_name":"xingrz/zmkx-sdk","owner":"xingrz","description":"zmkx.app 的 Python 实现，包含一个供二次开发的库和一个简单的 CLI 客户端","archived":false,"fork":false,"pushed_at":"2023-09-19T03:20:10.000Z","size":23,"stargazers_count":11,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-13T01:13:32.803Z","etag":null,"topics":["helloword","zmkx"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xingrz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2023-06-13T02:04:06.000Z","updated_at":"2024-12-02T15:09:23.000Z","dependencies_parsed_at":"2024-11-15T10:43:38.831Z","dependency_job_id":null,"html_url":"https://github.com/xingrz/zmkx-sdk","commit_stats":null,"previous_names":["xingrz/zmkx-sdk"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xingrz%2Fzmkx-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xingrz%2Fzmkx-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xingrz%2Fzmkx-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xingrz%2Fzmkx-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xingrz","download_url":"https://codeload.github.com/xingrz/zmkx-sdk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248650754,"owners_count":21139681,"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":["helloword","zmkx"],"created_at":"2024-11-15T10:32:16.595Z","updated_at":"2025-04-13T01:13:39.893Z","avatar_url":"https://github.com/xingrz.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"zmkx-sdk [![.github/workflows/build.yml](https://github.com/xingrz/zmkx-sdk/actions/workflows/build.yml/badge.svg)](https://github.com/xingrz/zmkx-sdk/actions/workflows/build.yml)\n========\n\n[![pypi][pypi-img]][pypi-url] [![downloads][downloads-img]][downloads-url] [![license][license-img]][license-url] [![issues][issues-img]][issues-url] [![stars][stars-img]][stars-url] [![commits][commits-img]][commits-url]\n\n[zmkx.app](https://github.com/xingrz/zmkx.app) 的 Python 实现，包含一个供二次开发的库和一个简单的 CLI 客户端。\n\n## 安装\n\n需要 Python 3.8 以上。\n\n```sh\npip3 install -U zmkx\n```\n\n## 快速上手\n\n本仓库提供了一个最简单的 [`examples/set_image.py`](examples/set_image.py) 演示换图功能：\n\n```sh\npython3 examples/set_image.py 你的图片.jpg\n```\n\n## 命令行\n\n本仓库实现了一个命令行工具 [`zmkx`](bin/zmkx) 来操作设备，命令格式如下：\n\n```\nzmkx [-s SERIAL] command ...\n```\n\n完整命令说明请参考 `zmkx -h`。\n\n#### 列出设备\n\n```\n$ zmkx list\n* HelloWord HW-75 Dynamic (序列号: 34314704001A002B)\n* HelloWord HW-75 Keyboard (序列号: 55895648066BFF53)\n```\n\n#### 监控电机状态\n\n```\n$ zmkx knob --monitor\n控制模式: 角度 | 当前角度:  23.7° | 当前速度:   -0.01 rad/s | 目标角度:  30.6° | 目标速度:    1.76 rad/s | 目标电压:   0.035 V\n```\n\n#### 换图\n\n```\n$ zmkx eink --set 图片.jpg --dither\n```\n\n## 相关链接\n\n* [zmkx.app](https://github.com/xingrz/zmkx.app)\n* [ZMK for HW-75](https://github.com/xingrz/zmk-config_helloword_hw-75)\n* [peng-zhihui/HelloWord-Keyboard](https://github.com/peng-zhihui/HelloWord-Keyboard)\n\n## 协议\n\n[MIT License](LICENSE)\n\n[pypi-img]: https://img.shields.io/pypi/v/zmkx?style=flat-square\n[pypi-url]: https://pypi.org/project/zmkx/\n[downloads-img]: https://img.shields.io/pypi/dm/zmkx?style=flat-square\n[downloads-url]: https://pypi.org/project/zmkx/\n[license-img]: https://img.shields.io/github/license/xingrz/zmkx-sdk?style=flat-square\n[license-url]: LICENSE\n[issues-img]: https://img.shields.io/github/issues/xingrz/zmkx-sdk?style=flat-square\n[issues-url]: https://github.com/xingrz/zmkx-sdk/issues\n[stars-img]: https://img.shields.io/github/stars/xingrz/zmkx-sdk?style=flat-square\n[stars-url]: https://github.com/xingrz/zmkx-sdk/stargazers\n[commits-img]: https://img.shields.io/github/last-commit/xingrz/zmkx-sdk?style=flat-square\n[commits-url]: https://github.com/xingrz/zmkx-sdk/commits/master\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxingrz%2Fzmkx-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxingrz%2Fzmkx-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxingrz%2Fzmkx-sdk/lists"}