# SpaceKatMotionMapper

**Repository Path**: wxggyy/space-kat-motion-mapper

## Basic Information

- **Project Name**: SpaceKatMotionMapper
- **Description**: 本项目用于 SpaceKat DIY 3D鼠标，可将3D动作转换为键鼠按键组合，扩展用法。

- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-05-05
- **Last Updated**: 2025-05-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SpaceKatMotionMapper

本项目用于 SpaceKat DIY 3D鼠标，可将3D动作转换为键鼠按键组合，扩展用法。

希望大家多给快捷键预设贡献配置文件，方便大家使用。

**快捷键预设项目地址**
[https://gitee.com/justkts/space-kat-motion-mapper-meta-key-presets](https://gitee.com/justkts/space-kat-motion-mapper-meta-key-presets)

## 介绍视频

### v0.1.x
[https://www.bilibili.com/video/BV1rs9bYoEXG](https://www.bilibili.com/video/BV1rs9bYoEXG)

### v0.2.x
[https://www.bilibili.com/video/BV1Y3QaYjEKv](https://www.bilibili.com/video/BV1Y3QaYjEKv)

### v0.2.7
[https://www.bilibili.com/video/BV18KVKzSE9Y](https://www.bilibili.com/video/BV18KVKzSE9Y)

## 视频所述之外新特性
1. 添加顶层透明浮窗提示，并可自定义大小及位置（v0.1.6+)
2. 可手动添加程序，识别其位于顶层时自动启动官方映射, 其余程序自动启动本程序映射（v0.1.7+)
3. 按键定义支持快速添加快捷键组合（v0.2.3+)
4. 按键定义支持延时，键盘宏get√（v0.2.3+)

## TODO
- [x] 模式切换的验证
- [x] 后台时顶层透明小窗的动作提示
- [x] 调整UI, 增加层级，简化布局

## 已知Bug
1. ~~静置一段时间不使用后由于读取异常会断联，需要重新连接，尽快修复~~ 已修复
2. ~~部分使用新的绿色化技术处理的软件无法通过Win32API获取到可执行文件地址，无法进行分应用配置~~ 因管理员权限问题，使用管理员权限启动即可。 

## 其他
UI由[AvaloniaUI](https://github.com/AvaloniaUI/Avalonia)实现

使用[Semi.Avalonia](https://github.com/irihitech/Semi.Avalonia)主题和[Ursa.Avalonia](https://github.com/irihitech/Ursa.Avalonia)控件库

HidApi.dll来自[https://github.com/libusb/hidapi](https://github.com/libusb/hidapi),使用其BSD许可

HID定义与组织学习自[PySpaceMouse](https://github.com/JakubAndrysek/PySpaceMouse)