71 lines
1.9 KiB
Markdown
71 lines
1.9 KiB
Markdown
---
|
|
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.
|