A graphical console greeter for greetd, written in Go with the Bubble Tea framework.

Quick Links

• Full Documentation - Complete guides, configuration, and usage instructions

Installation

Quick Install

One-line installer that works on most Linux distributions:

curl -fsSL https://raw.githubusercontent.com/Nomadcxx/sysc-greet/master/install.sh | sudo bash

The installer automatically detects your package manager and works on Arch Linux, Debian/Ubuntu, Fedora, and openSUSE. It'll handle compositor selection, install dependencies, and set everything up for you.

Build from Source

If you want to build it yourself, just clone the repo and run the installer:

git clone https://github.com/Nomadcxx/sysc-greet
cd sysc-greet
go run ./cmd/installer/

The installer walks you through compositor selection and configuration.

Arch Linux (AUR)

Three AUR packages available depending on which compositor you're using:

# Recommended (niri)
yay -S sysc-greet

# Hyprland variant
yay -S sysc-greet-hyprland

# Sway variant
yay -S sysc-greet-sway

NixOS (Flake)

If you're on NixOS, add sysc-greet to your flake:

flake.nix:

{
  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    sysc-greet = {
      url = "github:Nomadcxx/sysc-greet";
      inputs.nixpkgs.follows = "nixpkgs";
    };
  };

  outputs = { self, nixpkgs, sysc-greet, ... }: {
    nixosConfigurations.your-hostname = nixpkgs.lib.nixosSystem {
      system = "x86_64-linux";
      modules = [
        ./configuration.nix
        sysc-greet.nixosModules.default
      ];
    };
  };
}

configuration.nix:

{
  services.sysc-greet = {
    enable = true;
    compositor = "niri";  # or "hyprland" or "sway"
  };

  # Optional: Set initial session for auto-login
  services.sysc-greet.settings.initial_session = {
    command = "Hyprland";
    user = "your-username";
  };
}

Then rebuild:

sudo nixos-rebuild switch --flake .#your-hostname

Note: On NixOS, sysc-greet automatically uses the correct data directory via build-time path injection. The Nix store path is injected at build time, so no manual configuration or symlinks are needed (in theory)

Pre-built Packages (Debian/Ubuntu/Fedora)

Download pre-built packages from GitHub Releases:

Latest: v1.1.2

Debian/Ubuntu:

wget https://github.com/Nomadcxx/sysc-greet/releases/download/v1.1.2/sysc-greet_1.1.2_amd64.deb
sudo apt install ./sysc-greet_1.1.2_amd64.deb

Fedora:

wget https://github.com/Nomadcxx/sysc-greet/releases/download/v1.1.2/sysc-greet-1.1.2-1.x86_64.rpm
sudo dnf install ./sysc-greet-1.1.2-1.x86_64.rpm

See Installation Guide for details.

Documentation

For detailed docs, configuration guides, troubleshooting, and usage instructions, check out the full documentation site.

License

GPL-3.0