返回目录
开源项目自动化与 Agent 类新手

Keyviz:实时可视化按键与鼠标操作的开源工具

Keyviz 是一款免费开源工具,可实时可视化键盘按键与鼠标动作(如 Cmd + Click、Alt + Drag、点击与滚轮滚动),适合教程录制、演示讲解与协作分享场景。支持颜色、尺寸、布局、边框、背景、筛选、历史轨迹、位置与出入动画等全面自定义;提供 Windows MSI、macOS DMG 安装包,Linux 目前可在 X11 协议下通过源码构建使用。

0 次阅读2026/09/15 发布
Keyviz:实时可视化按键与鼠标操作的开源工具 来源图片

社区作者 · zZz

它解决什么问题

Keyviz 是一款免费、开源的工具,能够实时可视化你的按键与鼠标动作。它可以让观众在教程、演示、协作或任何需要的场合中,清楚看到你正在按下的便捷快捷键。

核心能力

⌨️ 按键 & 🖱️ 鼠标动作

  • 除普通按键外,还可视化鼠标动作,例如 Cmd + Click、Alt + Drag 等。
  • 在光标旁显示鼠标点击与滚轮滚动动作。
  • 配图 1 展示了按键可视化(Keystroke Visualization)效果。
  • 配图 2 展示了鼠标指示器(Mouse Indicator)效果。

⚙️ 全面自定义

不必接受默认样式,可视化的每个方面都由你控制(配图 3 为设置面板):

  • 样式(Styling):修改颜色(修饰键与普通键分别设置)、尺寸、布局、边框和背景。
  • 筛选(Filtering):通过热键或自定义过滤器控制显示哪些按键。
  • 历史(History):保留最近输入的可视轨迹。
  • 位置(Position):将可视化窗口移动到屏幕任意位置。
  • 动画(Animations):使用预设的进入与退出动画,自定义输入出现和消失的方式。

安装方式

Windows 与 macOS

从 GitHub Releases 页面下载 Keyviz 最新版本:

  • Windows:下载 .msi 安装程序,运行并按照步骤完成安装。
  • macOS:下载 .dmg 文件。
  • 注意:Keyviz 需要“输入监控(Input Monitoring)”和“辅助功能(Accessibility)”权限,请在以下位置启用:设置 > 隐私与安全性 > 输入监控 与 辅助功能。

Linux(x11)

Keyviz 兼容使用 X11 协议的 Linux。目前你可以按照下面的构建说明进行试用。

🛠️ 构建说明

如果你想贡献代码或从源码构建最新功能,请确保系统已安装 Node.js 与 Tauri。

  1. 克隆仓库:
命令
git clone https://github.com/mulaRahul/keyviz.git
命令
cd keyviz
  1. 安装依赖:
命令
npm install
  1. 构建可执行文件:
命令
npx tauri build

支持项目

  • 给仓库点 Star:帮助更多人发现该项目。
  • GitHub Sponsors:赞助 @mularahul。
  • Keyviz Pro:在支持该开源项目开发的同时获取专属功能,可在 keyviz.org/pro 升级到 Pro。

项目使用 Tauri 构建(Built with 🦀 and ❤️ using Tauri)。

— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。

安装 / 开始使用

准备环境

  • Windows / macOS 用户:无需开发环境,直接下载安装包即可。
  • Linux 用户:目前仅兼容 X11 协议,需要通过源码构建试用。
  • 源码构建者:需在系统中准备好 Node.js 与 Tauri。

一、Windows 与 macOS 安装

  1. 打开 GitHub Releases 页面,下载 Keyviz 最新版本。
  1. Windows:下载 .msi 安装程序,运行它并按照步骤完成安装。
  1. macOS:下载 .dmg 文件并安装。
  1. 首次运行常见问题(权限):Keyviz 需要“输入监控(Input Monitoring)”和“辅助功能(Accessibility)”权限,请前往 设置 > 隐私与安全性 > 输入监控 与 辅助功能 中启用;未授权时按键/鼠标动作可能无法被捕获显示。

二、Linux(x11)源码构建

  1. 确认系统使用 X11 协议,并已安装 Node.js 与 Tauri。
  1. 克隆仓库:
命令
git clone https://github.com/mulaRahul/keyviz.git
命令
cd keyviz
  1. 安装依赖:
命令
npm install
  1. 构建可执行文件:
命令
npx tauri build
  1. 首次运行:使用构建产物启动 Keyviz,按需在设置面板中调整样式、筛选、历史、位置与动画。

常见问题

  • 看不到按键/鼠标显示:检查系统是否已授予输入监控与辅助功能权限;Linux 下确认处于 X11 会话而非其它显示协议。
  • 显示内容过多或过杂:使用热键或自定义过滤器筛选要显示的按键。
  • 想更换外观:在设置面板调整颜色(修饰键与普通键)、尺寸、布局、边框、背景,以及进入/退出动画。
  • 想要更多功能:可了解项目方提供的 Keyviz Pro(keyviz.org/pro)。

来源教程配图

Keystroke Visualization
配图 1 · Keystroke Visualization查看原图
Mouse Indicator
配图 2 · Mouse Indicator查看原图
Settings Panel
配图 3 · Settings Panel查看原图

适用场景

录制教程或课程时向观众展示正在按下的快捷键
演示与演讲中实时呈现键盘与鼠标操作
直播或协作/远程会议中说明操作步骤
展示 Cmd + Click
Alt + Drag 等组合鼠标操作
按需筛选只显示特定快捷键
保持画面简洁
在 Linux X11 环境下自行构建并试用
开发者参与贡献或基于源码构建最新功能