Skip to content

bjarneo/aether

Repository files navigation

Aether Icon

aether_prodigy_low_res.mp4

Aether

A visual theming application for Omarchy. Extract colors from wallpapers and apply cohesive themes across your entire desktop.

Not using Omarchy? Aether works standalone on any Linux desktop. See the Standalone Guide for setup.

Features

  • Color Extraction — Intelligent palette generation from any wallpaper
  • Wallpaper Browser — Search wallhaven.cc or browse local files
  • Image Filters — Edit wallpapers before extraction (blur, exposure, presets)
  • Color Presets — Dracula, Nord, Gruvbox, Catppuccin, and more
  • Blueprints — Save and share themes as JSON
  • Screen Shaders — 80+ GLSL effects via hyprshade
  • Multi-App Support — Hyprland, Waybar, Kitty, Neovim, and 15+ more
  • Theme Scheduler — Auto-switch themes at scheduled times

Quick Start

Install (Arch Linux)

yay -S aether

Or install manually:

sudo pacman -S gjs gtk4 libadwaita libsoup3 imagemagick
git clone https://github.com/bjarneo/aether.git
cd aether && ./aether

Basic Usage

  1. Select a wallpaper (drag & drop, file picker, or wallhaven browser)
  2. Click Extract to generate a color palette
  3. Adjust colors as needed
  4. Click Apply Theme

That's it! Your theme is now applied across all configured applications.

CLI

# Generate theme from wallpaper (no GUI)
aether -g ~/wallpaper.jpg

# Apply saved blueprint
aether -a "My Theme"

# List blueprints
aether -l

# Open with wallpaper
aether -w ~/wallpaper.jpg

See aether --help for all options.

Documentation

Guide Description
Installation Detailed setup instructions
Color Extraction How the algorithm works
Wallpaper Editor Image filters & presets
Wallhaven Browse online wallpapers
Blueprints Save & restore themes
Custom Templates Add support for your apps
Shaders Screen effects and filters
Scheduler Automatic theme switching
Sharing Community sharing & protocol links
CLI Reference Command-line options
File System Where Aether stores files
Standalone Using Aether without Omarchy
Troubleshooting Common issues

Contributing

  • Templates: Add apps in templates/
  • Presets: Add themes to src/constants/presets.js
  • Components: Extend src/components/

See CLAUDE.md for architecture details.

License

MIT — Created by Bjarne Øverli

About

Aether, create Omarchy themes the easy way.

Topics

Resources

Stars

Watchers

Forks

Contributors 7