Skip to content
You are looking at the legacy documentation of AGS v1. Go to aylur.github.io/ags for AGS v2.

Installation

Nix

maintainer: @Aylur

The recommended way is the Home Manager module

or use nix flake profile install

Terminal window
nix profile install github:Aylur/ags

or try it without installing

Terminal window
nix run github:Aylur/ags

Arch

maintainer: @kotontrion

Terminal window
yay -S aylurs-gtk-shell # or aylurs-gtk-shell-git

Fedora

maintainer: @solopasha

Terminal window
sudo dnf copr enable solopasha/hyprland
sudo dnf install aylurs-gtk-shell

From source

Terminal window
# Arch
sudo pacman -S typescript npm meson gjs gtk3 gtk-layer-shell gnome-bluetooth-3.0 upower networkmanager gobject-introspection libdbusmenu-gtk3 libsoup3
Terminal window
# Fedora
sudo dnf install typescript npm meson gjs-devel gtk3-devel gtk-layer-shell gnome-bluetooth upower NetworkManager pulseaudio-libs-devel libdbusmenu-gtk3 libsoup3
Terminal window
# Ubuntu
sudo apt install node-typescript npm meson libgjs-dev gjs libgtk-layer-shell-dev libgtk-3-dev libpulse-dev network-manager-dev libgnome-bluetooth-3.0-dev libdbusmenu-gtk3-dev libsoup-3.0-dev
Terminal window
# clone, build, install
git clone --recursive https://github.com/Aylur/ags.git
cd ags
npm install
meson setup build
meson install -C build

Running

Terminal window
ags --help