GitHub starsGo 1.25.1
Configuration

Backgrounds

sysc-greet supports background effects and wallpapers.

sysc-greet supports background effects and wallpapers.

Background Effects

Access via F1 → Backgrounds:

EffectDescription
FireDOOM PSX-style fire effect
MatrixMatrix rain (green characters)
ASCII RainFalling ASCII characters (theme colors)
FireworksRandom firework explosions
AquariumSwimming fish and bubbles
SonarScanning sonar display
CracktroRetro scene-style animated art
PlasmaAnimated plasma field
AK-47Rotating AK-47 model
Australian SLRRotating L2A1 SAR model
Higgs FieldParticle field with travelling waves and vortex motion
Rotating modelsStatues, landmarks, and aircraft from the Backgrounds menu
Typewriter, Print, Beams, PourText and ASCII-art animations in the ASCII Effects submenu
NoneDisable background effect

Wallpapers

Custom image and video wallpapers are managed by gSlapper.

Themed Wallpapers

Location: /usr/share/sysc-greet/wallpapers/

Auto-switch when theme changes. Named sysc-greet-{theme}.png.

Custom Wallpapers

Location: /var/lib/greeter/Pictures/wallpapers/

Add your own images or videos:

sudo cp ~/my-wallpaper.mp4 /var/lib/greeter/Pictures/wallpapers/
sudo chown greeter:greeter /var/lib/greeter/Pictures/wallpapers/my-wallpaper.mp4

Access via F1 → Wallpaper.

Secondary outputs

On Niri, Cagebreak, Sway, Mango, and Hyprland 0.55+, sysc-greet can use an installed sysc-terminal to draw the selected effect and theme on secondary outputs. Experimental sysc-compositor builds use the same path through the Niri-compatible IPC exposed over NIRI_SOCKET. If no effect is selected, the compositor wallpaper remains. A selected GSlapper video suppresses secondary effects. An explicit --secondary-effect supplies a fallback only when the selected effect is None; its default is empty. Effects absent from the installed renderer are skipped without substitution.

OptionBehavior
--secondary-backgrounds=falseDisable secondary background effects; enabled by default
--secondary-exclude DP-3,HDMI-A-1Exclude named outputs from background effects
--secondary-effect pourUse this sysc-terminal effect when the greeter background is None

When the configured screensaver activates, it appears on every secondary output in a read-only fullscreen Kitty child and takes precedence over wallpapers and effects, including GSlapper video. A key or mouse event in any saver window wakes the primary greeter and closes the other saver windows. Disabling secondary background effects or excluding an output does not disable its screensaver. Install sysc-terminal separately to mirror effects; a missing or failed helper leaves login available.

On this page