From 65654282a98cb0590d498e4ed9c924f97646f1dc Mon Sep 17 00:00:00 2001 From: Aylur Date: Wed, 25 Sep 2024 23:22:01 +0000 Subject: docs: restructure --- docs/guide/ags/installation.md | 65 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 docs/guide/ags/installation.md (limited to 'docs/guide/ags/installation.md') diff --git a/docs/guide/ags/installation.md b/docs/guide/ags/installation.md new file mode 100644 index 0000000..0adcf68 --- /dev/null +++ b/docs/guide/ags/installation.md @@ -0,0 +1,65 @@ +# Installation + +## Nix + +maintainer: [@Aylur](https://github.com/Aylur) + +Read more about it on the [nix page](../getting-started/nix#ags) + +You can try without installing. + + +```sh +nix run github:aylur/ags/v2 -- --help +``` + +## Bulding AGS from source + +1. [Install Astal](../getting-started/installation.md) if you have not already + +2. Install the following dependencies + +:::code-group + +```sh [ Arch] +sudo pacman -Syu go npm gjs +``` + +```sh [ Fedora] +sudo dnf install golang npm gjs +``` + +```sh [ Ubuntu] +sudo apt install golang-go npm gjs +``` + +::: + +3. Clone the repo and Install + + +```sh +git clone https://github.com/aylur/ags.git +cd ags/src +git checkout v2 # https://github.com/Aylur/ags/pull/504 +go install +``` + +:::info +If you have installed Astal **not** in `/usr` make sure to set its path. + +```sh +go install -ldflags "-X main.astalGjs=$(pkg-config --variable prefix astal-0.1)/share/astal/gjs" +``` + +::: + +:::tip +`go install` installs the `ags` binary to `$GOPATH/bin` so make sure its in your `$PATH`. +You can move it to another directory if you like. For example + +```sh +mv $GOPATH/bin/ags ~/.local/bin/ags +``` + +::: -- cgit v1.2.3