Troubleshooting

March 20, 2026 ยท View on GitHub

App Won't Start

# Ensure webkit2gtk is installed
sudo pacman -S webkit2gtk

# Run from terminal to see errors
./aether

Wallhaven Not Loading

  • Check internet connection
  • Rate limit: 45 req/min without API key
  • Add API key in Settings for higher limits
  • Clear cache: rm -rf ~/.cache/aether/wallhaven-*

Waybar Disappears (Widget Mode)

When using --widget-blueprint, Aether runs with layer-shell which can conflict with Waybar.

Solution: Already fixed in Aether. It clears LD_PRELOAD when applying themes.

Theme Not Applying

  1. Check ~/.config/aether/theme/ for generated files
  2. Verify symlink: ls -la ~/.config/omarchy/themes/aether/
  3. Run manually: omarchy-theme-set aether

Colors Look Wrong

  • Try different extraction modes: aether --generate wallpaper.jpg --extract-mode material
  • Check if image is too dark/bright for good extraction
  • Use color adjustments in the sidebar