Skip to content

Commit

Permalink
Merge pull request mulaRahul#168 from Miuzarte/main
Browse files Browse the repository at this point in the history
add Chinese README
  • Loading branch information
mulaRahul authored Jul 18, 2023
2 parents 4d71968 + 7a4a272 commit 9e102ed
Show file tree
Hide file tree
Showing 2 changed files with 101 additions and 6 deletions.
13 changes: 7 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,14 +2,14 @@

Keyviz is a free and open-source software to visualise your keystrokes and mouse actions in real time! Let your audience know what handy shortcuts/keys you're pressing during screencasts, presentations, collaborations, or whenever you need it.

**English** | [简体中文](./README_zh_CN.md)

# ⌨️ Keystrokes & 🖱️ Mouse Actions

Now you can visualize mouse actions! Not only mouse clicks, you can also visualize mouse actions along with keystrokes like <kbd>Cmd</kbd> + <kbd>Click</kbd>, <kbd>Alt</kbd> + <kbd>Drag</kbd>, etc.

![key-visualizer](previews/visualizer-bar.svg)


# 🎨 Stylize

Don't restrain yourself to just black & white! You can customize every aspect of the visualization. The visualisation's style, size, colour (modifier and regular keys), border, icon, etc.
Expand All @@ -18,7 +18,7 @@ Don't restrain yourself to just black & white! You can customize every aspect of

Powerful and easy-to-use configuration options.

- Filter normal keys and only display shortcuts like <kbd>Cmd</kbd> + <kbd>K</kbd>
- Filter normal keys and only display shortcuts like <kbd>Cmd</kbd> + <kbd>K</kbd> **(Default)**
- Adjust the visualisation position on the screen
- Decide how much the visualisation lingers on the screen before animating out
- Switch between animation presets to animate your visualisation in & out
Expand All @@ -27,7 +27,7 @@ Powerful and easy-to-use configuration options.

# 📥 Installation

You can download the latest version of keyviz from the [Github Releases]() page. For the installer, unzip the downloaded file, run the installer and follow the familiar steps to install keyviz.
You can download the latest version of keyviz from the [Github Releases](github.com/mulaRahul/keyviz/releases) page. For the installer, unzip the downloaded file, run the installer and follow the familiar steps to install keyviz.

<details>
<summary>🥄 Scoop</summary>
Expand Down Expand Up @@ -56,11 +56,11 @@ You can download the latest version of keyviz from the [Github Releases]() page.
If you're getting a `.dll` missing error after installing the application, you're missing the required Visual C++ redistributables. You can get the same from here [VSC++ Redist](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170).

</details>
</br>

</br>

# 🛠️ Build Instructions

You can always further develop/build the project by yourself. First of all ensure that you've setup Flutter on your system. If not follow this [guide](https://docs.flutter.dev/get-started/install).

After setting up flutter, clone the repository or download the zip and unpack the same.
Expand All @@ -69,6 +69,7 @@ After setting up flutter, clone the repository or download the zip and unpack th
mkdir keyviz
git clone https://github.com/mulaRahul/keyviz.git .
```

Move inside the flutter project and run the build command to create an executable -

```bash
Expand All @@ -83,4 +84,4 @@ flutter build windows

# 💖 Support

As keyviz is freeware, the only way I can earn is through your generous donations. It helps free my time and work more on keyviz.
As keyviz is freeware, the only way I can earn is through your generous donations. It helps free my time and work more on keyviz.
94 changes: 94 additions & 0 deletions README_zh_CN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
![keyviz-2.0](previews/banner.svg)

Keyviz,一个免费开源的实时键鼠输入可视化软件,让观众了解你在演示的过程中按下了什么快捷键

**简体中文** | [English](./README.md)

# ⌨️ 键盘输入 & 🖱️ 鼠标操作

Keyviz也可以显示鼠标、键盘+鼠标的操作,比如 <kbd>Cmd</kbd> + <kbd>Click</kbd> 或 <kbd>Alt</kbd> + <kbd>Drag</kbd>

![key-visualizer](previews/visualizer-bar.svg)

# 🎨 个性化

不只有黑与白,Keyviz可以高度自定义按键的显示效果,包括但不限于:预设风格、尺寸、键位图标显示切换(Shift的↑)、辅助键和常规键的颜色、边框

![settings-window](previews/settings.svg)

强大易用的设置菜单

- 隐藏常规键,留下组合键,比如只显示 <kbd>Cmd</kbd> + <kbd>K</kbd>**(默认)**
- 显示位置(区域、距离主显示器边缘的距离)
- 按键显示的停留时间
- 按键切入切出的动画

</br>

# 📥 安装

[Github Releases](github.com/mulaRahul/keyviz/releases) 下载最新版,根据操作系统安装/解压即用,或者通过下面的包管理器安装

<details>
<summary>🥄 Scoop</summary>

```bash
scoop bucket add extras # first, add the bucket
scoop install keyviz
```

</details>

<details>
<summary>🪟 Winget</summary>

```bash
winget install mulaRahul.Keyviz
```

</details>

</br>

<details>
<summary>提示缺少<code>*.dll</code>?</summary>

如果运行程序弹出了缺少`.dll`文件的错误,大概率是环境缺少了VC++运行库,你可以在[**这里**](https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist?view=msvc-170)下载安装

</details>

</br>

# 🛠️ 构建说明

在进一步开发、编译之前,请确保在系统上安装好了Flutter,可以参照[官方的安装指南](https://docs.flutter.dev/get-started/install)

安装并设置好Flutter后,克隆仓库或下载zip并解压

```bash
mkdir keyviz
git clone https://github.com/mulaRahul/keyviz.git .
```

cd到项目文件夹内 开始编译

```bash
cd keyviz
# 获取依赖
flutter pub get
# 编译可执行文件
flutter build windows
```

</br>

# 💖 支持该项目

Keyviz是一个免费项目,唯一的收益来源只有你们的慷慨捐赠,这将有助于我腾出更多的空余时间用于开发Keyviz

</br>

<details>
<summary></summary>
译于23/7/18,v2.0.0a发布的七天后,有些条目是作者还没改上去的,部分描述其实跟软件本体差挺多的
</details>

0 comments on commit 9e102ed

Please sign in to comment.