Switch theme to Doks
This commit is contained in:
8
content/docs/kbdemu/_index.md
Normal file
8
content/docs/kbdemu/_index.md
Normal file
@@ -0,0 +1,8 @@
|
||||
---
|
||||
title: "KbdEmu Docs"
|
||||
draft: true
|
||||
description: "Documentation for KbdEmu, the HID emulator"
|
||||
menu:
|
||||
docs:
|
||||
parent: "docs"
|
||||
---
|
||||
70
content/docs/kbdemu/installation.md
Normal file
70
content/docs/kbdemu/installation.md
Normal file
@@ -0,0 +1,70 @@
|
||||
---
|
||||
title: "Installation"
|
||||
draft: false
|
||||
description: "Installing kbdemu"
|
||||
---
|
||||
{{< appveyor-ci project="kbdemu" projectID="km2f1wiy7enuh6il" >}}
|
||||
{{< minio-s3 project="kbdemu" >}}
|
||||
|
||||
## Using precompiled binary
|
||||
KbdEmu uses continuous integration to compile. You can find the binary by
|
||||
clicking the CI badge above, selecting "Ubuntu2004" for the linux build or
|
||||
"macOS" for the macOS build, and then going to the artifacts tab.
|
||||
|
||||
## Building from source
|
||||
|
||||
### Downloading
|
||||
KbdEmu is hosted in two places, Gitea and Gitlab. Either one can be used as
|
||||
it is mirrored from Gitea to Gitlab
|
||||
|
||||
{{< button-gitea color="green" project="kbdemu" text="KbdEmu" >}}
|
||||
{{< button-gitlab color="OrangeRed" project="kbdemu" text="KbdEmu" >}}
|
||||
|
||||
To download kbdemu, you can either use the download button on one of the above, or
|
||||
you can use the git command
|
||||
|
||||
To clone kbdemu using the command, run one of the following commands:
|
||||
```bash
|
||||
git clone https://gitea.arsenm.dev/Arsen6331/kbdemu
|
||||
OR
|
||||
git clone https://gitlab.com/moussaelianarsen/kbdemu
|
||||
```
|
||||
|
||||
Now, you will want to `cd` into the root of this repo before completing the rest
|
||||
of these instructions
|
||||
|
||||
### Building
|
||||
|
||||
Since KbdEmu is written in go, you will need go installed in order to compile it.
|
||||
Most linux distros call the package providing it either `go` or `golang`.
|
||||
|
||||
Once go is installed, you can check that it runs by running
|
||||
```bash
|
||||
go version
|
||||
```
|
||||
To compile KbdEmu, run the following commands:
|
||||
```bash
|
||||
go get github.com/go-vgo/robotgo
|
||||
go get github.com/BurntSushi/toml
|
||||
go get github.com/rs/zerolog/log
|
||||
source .envrc
|
||||
go build
|
||||
```
|
||||
|
||||
### Installing
|
||||
|
||||
To install kbdemu, run the following command:
|
||||
|
||||
```bash
|
||||
sudo install -Dm755 kbdemu /usr/bin
|
||||
```
|
||||
|
||||
Once this command completes, to test whether kbdemu was installed properly, run
|
||||
this command:
|
||||
|
||||
```bash
|
||||
kbdemu
|
||||
```
|
||||
|
||||
You should get an error warning you that kbdemu cannot find a TOML file. If you do,
|
||||
kbdemu is properly installed.
|
||||
69
content/docs/kbdemu/usage.md
Normal file
69
content/docs/kbdemu/usage.md
Normal file
@@ -0,0 +1,69 @@
|
||||
---
|
||||
title: "Usage"
|
||||
draft: false
|
||||
description: "Using kbdemu"
|
||||
---
|
||||
{{< appveyor-ci project="kbdemu" projectID="km2f1wiy7enuh6il" >}}
|
||||
{{< minio-s3 project="kbdemu" >}}
|
||||
|
||||
This page assumes you have already installed KbdEmu. If not, follow the installation
|
||||
instructions on the installation page.
|
||||
|
||||
{{< button text="Installation" link="../installation" color="blue">}}
|
||||
|
||||
### Configs
|
||||
|
||||
KbdEmu uses TOML configs to tell it what to do. This is the example config which
|
||||
contains all supported features:
|
||||
|
||||
```toml
|
||||
[[action]]
|
||||
type = "var"
|
||||
action = "set key to z"
|
||||
|
||||
[[action]]
|
||||
type = "kbd"
|
||||
action = "hold key @key@"
|
||||
|
||||
[[action]]
|
||||
type = "misc"
|
||||
action = "wait 1 second"
|
||||
|
||||
[[action]]
|
||||
type = "kbd"
|
||||
action = "release key @key@"
|
||||
|
||||
[[action]]
|
||||
type = "kbd"
|
||||
action = "press space"
|
||||
|
||||
[[action]]
|
||||
type = "kbd"
|
||||
action = "type AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRrSsTtUuVvWwXxYyZz"
|
||||
|
||||
[[action]]
|
||||
type = "mse"
|
||||
action = "scroll up 5"
|
||||
|
||||
[[action]]
|
||||
type = "mse"
|
||||
action= "right click"
|
||||
|
||||
[[action]]
|
||||
type = "mse"
|
||||
action = "move to {0,0}"
|
||||
|
||||
[[action]]
|
||||
type = "misc"
|
||||
action = "show message Actions complete!"
|
||||
```
|
||||
|
||||
As you can see, the configs are pretty simple. Here is a list of all the currently
|
||||
supported features:
|
||||
{{<table "f6 w-100 mw8 center">}}
|
||||
| Var Type | Misc Type | Kbd Type | Mse Type |
|
||||
|-------------------|-------------------|--------------|----------------|
|
||||
| Setting Variables | Delays | Hold Keys | Scrolling |
|
||||
| | Showing Messages | Release Keys | Mouse Clicks |
|
||||
| | | Type Strings | Mouse Movement |
|
||||
{{</table>}}
|
||||
Reference in New Issue
Block a user