Skip to content

Hotakus/XialloControl

Repository files navigation

XialloControl

通用手柄映射软件(支持各种主流手柄 Xbox、PS)

GitHub release Rust License Repo size
Tauri Rust Tauri


功能特点:

XialloControl 是一款:

🎨 设计:

  • 极简:程序精简,windows 安装包仅有 4 MB 左右
  • 美观程度高,卡片式UI设计,操作界面一目了然!
  • 高性能服务提供!后端采用 Rust 语言设计,高效操作,丝滑无比!

⚙️ 高级控制:

  • 支持单击、双击、长按映射,高度自定义。
  • 支持鼠标模拟控制,可以将摇杆作为鼠标使用(后续可能添加对 DS4 的触控板支持)
  • 支持自定义摇杆死区范围,优化操作精度
  • 支持市面多种手柄,如 Xbox、PS 等
  • 高度自定义手柄键位映射(支持鼠标、键盘映射、键盘鼠标按键和滚轮混合映射, 支持各种快捷键,如:Shift+Alt+鼠标滚轮等复杂混合映射,满足多场景支持)
  • 更多:拖动列表项控制映射顺序

🎮 创意工作优化:

  • 灵敏度可调,适应各种用户各种手感!
  • 支持摇杆映射(支持摇杆旋转映射、支持摇杆死区调整、支持摇杆映射为鼠标移动、画笔大小、画布缩放等操作)
  • 支持多预设方案(保存和导入多个预设配置,适应不同软件和工作流程)
  • 支持副预设快速切换功能,通过绑定切换按键,同时控制两套映射

其他:

  • 支持开机自启,可调“自动连接手柄”,让你从开机到工作顺滑无比!
  • 支持托盘运行,最小化到系统托盘,不干扰创作过程!
  • 安全卸载,卸载后不影响手柄正常功能,您可以放心使用

🖼️ 界面预览

主界面:

XialloControl界面预览

添加映射:

XialloControl界面预览

摇杆设置:

XialloControl界面预览

软件设置:

XialloControl界面预览


🛠️ 开发与运行

前置环境

依赖 说明
Rust 工具链 stable 通道,edition 2024
Node.js + pnpm 包管理器固定为 pnpm(见 pnpm-lock.yaml
WebView2 Runtime Windows 平台运行依赖
MSVC 构建工具 Rust MSVC target 链接所需
Git 子模块 src-tauri/third-party/gilrs 通过 .gitmodules 引入

命令

# 克隆时一并拉取 gilrs 子模块
git clone --recurse-submodules <repo>

# 已克隆则补拉一次子模块
git submodule update --init --recursive

# 安装前端依赖(必须使用 pnpm,禁止 npm/yarn)
pnpm install

# 启动开发环境(自动启动 Vite 于 1420 端口 + Tauri 窗口)
pnpm tauri dev

# 类型检查 + 前端生产构建(产物输出到 dist/)
pnpm build

📜 许可证

本项目的代码部分遵循 GNU General Public License v3.0 许可证开源。

关于图形资源

本项目中使用的所有位于 src/assets/controller 目录下的 .svg 手柄布局图是本项目的原创作品,其版权归项目作者所有。

这些图形资源在 GPLv3 许可范围内,并保留所有权利 (All Rights Reserved)

未经项目作者明确的书面许可,禁止以任何形式对这些图形资源进行复制、修改、分发或用于商业目的。

About

通用手柄映射键鼠软件

Topics

Resources

License

Stars

10 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors