mirror of
https://github.com/feschber/lan-mouse.git
synced 2026-04-14 19:21:28 +03:00
simplify windows installation instructions
This commit is contained in:
committed by
GitHub
parent
db96717044
commit
e52febf457
51
README.md
51
README.md
@@ -58,13 +58,13 @@ input capture (to send events *to* other clients) on different operating systems
|
|||||||
> Otherwise input capture will not work.
|
> Otherwise input capture will not work.
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
### Install with cargo
|
### Install via cargo
|
||||||
```sh
|
```sh
|
||||||
cargo install lan-mouse
|
cargo install lan-mouse
|
||||||
```
|
```
|
||||||
|
|
||||||
### Download from Releases
|
### Download from Releases
|
||||||
The easiest way to install Lan Mouse is to download precompiled release binaries from the [releases section](https://github.com/feschber/lan-mouse/releases).
|
Precompiled release binaries for Windows, MacOS and Linux are available in the [releases section](https://github.com/feschber/lan-mouse/releases).
|
||||||
|
|
||||||
For Windows, the depenedencies are included in the .zip file, for other operating systems see [Installing Dependencies](#installing-dependencies).
|
For Windows, the depenedencies are included in the .zip file, for other operating systems see [Installing Dependencies](#installing-dependencies).
|
||||||
|
|
||||||
@@ -83,7 +83,9 @@ paru -S lan-mouse-bin
|
|||||||
- flake: [README.md](./nix/README.md)
|
- flake: [README.md](./nix/README.md)
|
||||||
|
|
||||||
|
|
||||||
### Building from Source
|
### Manual Installation
|
||||||
|
|
||||||
|
First make sure to [install the necessary dependencies](#installing-dependencies).
|
||||||
|
|
||||||
Build in release mode:
|
Build in release mode:
|
||||||
```sh
|
```sh
|
||||||
@@ -138,56 +140,62 @@ For a detailed list of available features, checkout the [Cargo.toml](./Cargo.tom
|
|||||||
|
|
||||||
|
|
||||||
## Installing Dependencies
|
## Installing Dependencies
|
||||||
|
<details>
|
||||||
#### Macos
|
<summary>MacOS</summary>
|
||||||
|
#### MacOS
|
||||||
```sh
|
```sh
|
||||||
brew install libadwaita
|
brew install libadwaita
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>Ubuntu and derivatives</summary>
|
||||||
#### Ubuntu and derivatives
|
#### Ubuntu and derivatives
|
||||||
```sh
|
```sh
|
||||||
sudo apt install libadwaita-1-dev libgtk-4-dev libx11-dev libxtst-dev
|
sudo apt install libadwaita-1-dev libgtk-4-dev libx11-dev libxtst-dev
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>Arch and derivatives</summary>
|
||||||
#### Arch and derivatives
|
#### Arch and derivatives
|
||||||
```sh
|
```sh
|
||||||
sudo pacman -S libadwaita gtk libx11 libxtst
|
sudo pacman -S libadwaita gtk libx11 libxtst
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>Fedora and derivatives</summary>
|
||||||
#### Fedora and derivatives
|
#### Fedora and derivatives
|
||||||
```sh
|
```sh
|
||||||
sudo dnf install libadwaita-devel libXtst-devel libX11-devel
|
sudo dnf install libadwaita-devel libXtst-devel libX11-devel
|
||||||
```
|
```
|
||||||
|
</details>
|
||||||
|
<details>
|
||||||
|
<summary>Windows</summary>
|
||||||
|
|
||||||
#### Windows
|
#### Windows
|
||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> This is only necessary when building lan-mouse from source. The windows release comes with precompiled gtk dlls.
|
> This is only necessary when building lan-mouse from source. The windows release comes with precompiled gtk dlls.
|
||||||
|
|
||||||
Follow the instructions at [gtk-rs.org](https://gtk-rs.org/gtk4-rs/stable/latest/book/installation_windows.html)
|
- First install [Rust](https://www.rust-lang.org/tools/install).
|
||||||
|
|
||||||
|
- Then follow the instructions at [gtk-rs.org](https://gtk-rs.org/gtk4-rs/stable/latest/book/installation_windows.html)
|
||||||
|
|
||||||
*TLDR:*
|
*TLDR:*
|
||||||
|
|
||||||
Build gtk from source
|
Build gtk from source
|
||||||
|
|
||||||
- The following commands should be run in an admin power shell instance:
|
- The following commands should be run in an **admin power shell** instance:
|
||||||
```sh
|
```sh
|
||||||
# install chocolatey
|
# install chocolatey
|
||||||
Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
|
Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
|
||||||
|
|
||||||
# install python 3.11 (Version is important, as 3.12 does not work currently) -> Has been fixed recently
|
# install gvsbuild dependencies
|
||||||
choco install python --version=3.11.0
|
choco install python git msys2 visualstudio2022-workload-vctools
|
||||||
|
|
||||||
# install git
|
|
||||||
choco install git
|
|
||||||
|
|
||||||
# install msys2
|
|
||||||
choco install msys2
|
|
||||||
|
|
||||||
# install Visual Studio 2022
|
|
||||||
choco install visualstudio2022-workload-vctools
|
|
||||||
```
|
```
|
||||||
|
|
||||||
- The following commands should be run in a regular power shell instance:
|
- The following commands should be run in a **regular power shell** instance:
|
||||||
|
|
||||||
```sh
|
```sh
|
||||||
# install gvsbuild with python
|
# install gvsbuild with python
|
||||||
@@ -203,11 +211,12 @@ pipx install gvsbuild
|
|||||||
gvsbuild build gtk4 libadwaita librsvg
|
gvsbuild build gtk4 libadwaita librsvg
|
||||||
```
|
```
|
||||||
|
|
||||||
Make sure to add the directory `C:\gtk-build\gtk\x64\release\bin`
|
- **Make sure to add the directory** `C:\gtk-build\gtk\x64\release\bin`
|
||||||
[to the `PATH` environment variable]((https://learn.microsoft.com/en-us/previous-versions/office/developer/sharepoint-2010/ee537574(v=office.14))). Otherwise the project will fail to build.
|
[**to the `PATH` environment variable**]((https://learn.microsoft.com/en-us/previous-versions/office/developer/sharepoint-2010/ee537574(v=office.14))). Otherwise the project will fail to build.
|
||||||
|
|
||||||
To avoid building GTK from source, it is possible to disable
|
To avoid building GTK from source, it is possible to disable
|
||||||
the gtk frontend (see conditional compilation below).
|
the gtk frontend (see conditional compilation below).
|
||||||
|
</details>
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
### Gtk Frontend
|
### Gtk Frontend
|
||||||
|
|||||||
Reference in New Issue
Block a user