Skip to content

standalone.md

Latest commit

 

History

History
116 lines (77 loc) · 2.65 KB

standalone.md

File metadata and controls

116 lines (77 loc) · 2.65 KB

Standalone Usage (Non-Omarchy Systems)

Aether can be used on any Linux or macOS system, not just Omarchy. When running outside of Omarchy, theme files are generated but not automatically applied system-wide.

On macOS, theme files are generated to ~/Library/Application Support/aether/theme/.

Theme Output Location

When you click "Apply Theme", Aether generates all theme files to:

~/.config/aether/theme/

Directory Structure

~/.config/aether/theme/
├── backgrounds/          # Wallpaper copy
│   └── wallpaper.jpg
├── hyprland.conf         # Hyprland color config
├── kitty.conf            # Kitty terminal theme
├── waybar.css            # Waybar stylesheet
├── gtk.css               # GTK theme (if enabled)
├── aether.override.css   # Aether app theme
├── neovim.lua            # Neovim colorscheme (if enabled)
├── vscode.json           # VSCode color theme (if enabled)
├── aether.zed.json       # Zed editor theme (if enabled)
└── ...                   # Other app configs

Manual Integration

Hyprland

Source the generated config in your ~/.config/hypr/hyprland.conf:

source = ~/.config/aether/theme/hyprland.conf

Kitty Terminal

Include the theme in your ~/.config/kitty/kitty.conf:

include ~/.config/aether/theme/kitty.conf

Waybar

Import the stylesheet in your Waybar config or use directly:

@import url("file:///home/YOUR_USER/.config/aether/theme/waybar.css");

Or symlink it:

ln -sf ~/.config/aether/theme/waybar.css ~/.config/waybar/colors.css

Rofi

Reference the theme in your rofi config:

@theme "~/.config/aether/theme/rofi.rasi"

Neovim

Load the colorscheme in your Neovim config:

dofile(vim.fn.expand("~/.config/aether/theme/neovim.lua"))

Wallpaper (swaybg)

Set the wallpaper manually:

swaybg -i ~/.config/aether/theme/backgrounds/wallpaper.jpg -m fill

Or add to your Hyprland config:

exec-once = swaybg -i ~/.config/aether/theme/backgrounds/wallpaper.jpg -m fill

GTK Theming

If you enable "GTK Theme" in settings, Aether copies gtk.css to:

  • ~/.config/gtk-3.0/gtk.css
  • ~/.config/gtk-4.0/gtk.css

This applies the color scheme to GTK applications system-wide.

Automatic Reload

For applications that support live reload, changes apply immediately. Others may require:

  • Restarting the application
  • Reloading the config (e.g., hyprctl reload for Hyprland)

Custom Templates

You can add custom application templates in:

~/.config/aether/custom/

See Custom Apps for details on creating custom templates.