GitHub starsGo 1.25.1
Configuration

Themes

sysc-greet includes multiple color themes. Themes affect the entire color scheme of the greeter including backgrounds, borders, text, and accent ele...

sysc-greet includes multiple color themes. Themes affect the entire color scheme of the greeter including backgrounds, borders, text, and accent elements.

Available Themes

ThemePrimary ColorDescription
Dracula#bd93f9Dark purple-blue theme
Gruvbox#fe8019Warm dark theme
Material#80cbc4Material Design dark theme
Nord#81a1c1Arctic blue-toned dark theme
Tokyo Night#7aa2f7Modern dark theme
Catppuccin#cba6f7Soft pastel dark theme
Solarized#268bd2Solarized dark theme
Monochrome#ffffffBlack and white minimal theme
TransIsHardJob#5BCEFATransgender flag colors
Eldritch#37f499Purple and green theme
RAMA#ef233cRAMA keyboard aesthetics
Dark#ffffffTrue black and white minimal theme
Ayu#e6b450Dark theme with a gold primary and green and blue accents
Amber#ffc107Brown-black with amber accents
Blue#42a5f5Blue-grey with a blue primary
Purple#d0bcffNear-black with Material violet
Green#4caf50Green-black with a green primary
Orange#ff6d00Brown-black with an orange primary
Coral#ffb4abBrown-black with a soft coral primary
Cyan#00bcd4Dark slate with a cyan primary
Eldritch-Abyss#2dcc82Deep indigo with green, teal, and violet accents
Kanagawa#76946aInk-wash dark theme with pine and wave blue accents
Noctalia#fff59bMidnight blue with pale yellow, periwinkle, and mint accents
Pink#e91e63Brown-black with a magenta-pink primary
Red#f44336Brown-black with a red primary
Rose-Pine#ebbcbaWarm rose and foam accents on a plum base
Void#ffffffTrue black with a white primary

Fifteen themes ship as TOML files in /usr/share/sysc-greet/themes/: Ayu, Amber, Blue, Coral, Cyan, Eldritch-Abyss, Green, Kanagawa, Noctalia, Orange, Pink, Purple, Red, Rose-Pine, and Void. Ayu, Amber, Blue, Purple, Green and Orange use the same names and palette colors as sysc-shell. To change one, copy it to ~/.config/sysc-greet/themes/; a user theme with the same name wins.

Changing Themes

Press F1 → Themes to cycle through available themes. Your selection is saved automatically.

Use --theme blue to choose a startup theme. Names are case insensitive; an explicit theme overrides the saved selection. Test mode ignores saved preferences.

Custom Themes

Create custom themes by placing TOML files in:

  • /usr/share/sysc-greet/themes/ (system-wide)
  • ~/.config/sysc-greet/themes/ (user)

Custom themes appear in F1 → Themes alongside built-in themes.

Format

# my-theme.toml
name = "My Theme"

[colors]
bg_base = "#1a1a2e"
bg_active = "#2a2a3e"
primary = "#e94560"
secondary = "#0f3460"
accent = "#16213e"
warning = "#f59e0b"
danger = "#ef4444"
fg_primary = "#ffffff"
fg_secondary = "#cccccc"
fg_muted = "#888888"
border_focus = "#e94560"

All color fields are required. Use hex format (#RRGGBB).

Example themes are provided in the repository at examples/themes/.

Community Examples

Piink

A vibrant pink and magenta theme by Pat8998.

# piink.toml
name = "Piink"

[colors]
bg_base = "#000000"
bg_active = "#ad1a5d"
primary = "#f72585"
secondary = "#a71aad"
accent = "#f72585"
warning = "#ffff00"
danger = "#ff0000"
fg_primary = "#ee33ee"
fg_secondary = "#a125f7"
fg_muted = "#ee33ee"
border_focus = "#711aad"

Piink theme

This theme also pairs well with a custom ASCII config using braille-art. See examples/themes/piink.toml in the repository.

Have a custom theme you'd like to share? Open an issue and we'll add it here.

Generating Wallpapers

After adding a new theme, regenerate wallpapers to include theme-matched backgrounds:

cd scripts/
python3 generate-wallpapers.py

This creates wallpapers for all themes in /usr/share/sysc-greet/wallpapers/. See Wallpapers for more options.

Background Effects

Custom themes color the built-in effects, including Fire, Matrix, ASCII Rain, Fireworks, Aquarium, Sonar, Cracktro, Plasma, AK-47, Australian SLR, Higgs Field, and rotating models. The effects use palettes derived from your theme's colors:

  • Fire uses bg_base → warning → danger → primary gradient
  • Matrix uses bg_base → secondary → primary for the falling characters
  • Rain uses primary, secondary, accent for the drops
  • Fireworks uses all accent colors for variety

No additional configuration needed - just select your custom theme and enable an effect.

Kitty color output

greetd starts sysc-greet as a fullscreen Kitty process under the selected Wayland compositor. Kitty provides the TrueColor profile used by the greeter. Color profile fallback behavior is not a substitute for testing the greeter in Kitty on the target compositor.

On this page