aether_rewrite_v4_compressed.mp4
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.
- Pure Go median-cut algorithm that generates a full 16-color ANSI palette from any wallpaper
- 8 extraction modes: Normal, Monochromatic, Analogous, Pastel, Material, Colorful, Muted, and Bright
- 12 fine-tuning sliders (vibrance, contrast, temperature, shadows, highlights, and more)
- Light and dark mode toggle with automatic color anchor swapping
- Batch processing for up to 10 wallpapers at once
- Search and download wallpapers from wallhaven.cc directly in the app
- Full wallpaper editor with blur, exposure, sharpen, vignette, grain, and color toning
- 12 one-click image presets: Cinematic, Vintage, Film, Dramatic, and more
- Drag-and-drop, file picker, and local directory scanning
- 24 built-in color presets including Dracula, Nord, Gruvbox, Catppuccin, and Sakura
- Import 250+ community Base16 color schemes
- Save and restore complete themes as blueprint files
- Export themes as shareable packages with selective app inclusion
- 20+ pre-configured apps: Hyprland, Waybar, Kitty, Alacritty, Ghostty, Neovim, VS Code, Zed, btop, and more
- Template system with hex, RGB, RGBA, and stripped format modifiers
- Per-app overrides, reload hooks, and post-apply scripts
- Add your own apps with custom templates
- WCAG contrast ratio checker with AAA/AA accessibility grading
- Gradient generator and single-color palette builder
- 50-step undo/redo history
- Headless CLI for scripting, keybinds, and automation
yay -S aetherOr build from source:
sudo pacman -S go webkit2gtk
git clone https://github.com/bjarneo/aether.git
cd aether && make build- Select a wallpaper (drag & drop, file picker, or wallhaven browser)
- Click Extract to generate a color palette
- Adjust colors as needed
- Click Apply Theme
aether --generate ~/wallpaper.jpg
aether --apply-blueprint "My Theme"
aether --list-blueprintsSee aether --help for all options.
git clone https://github.com/bjarneo/aether.git
cd aether
# Install frontend dependencies
cd frontend && npm install && cd ..
# Run in development mode (hot reload)
wails dev
# Build production binary
wails buildPrerequisites: Go 1.23+, Node.js 18+, Wails v2, webkit2gtk
| Guide | Description |
|---|---|
| Installation | Detailed setup instructions |
| CLI Reference | Command-line options |
| Color Extraction | How the algorithm works |
| Base16 Schemes | Import community color schemes |
| Wallpaper Editor | Image filters and presets |
| Wallhaven | Browse online wallpapers |
| Blueprints | Save and restore themes |
| Custom Templates | Add support for your apps |
| Custom Apps | Per-app template system |
| File System | Where Aether stores files |
| Standalone | Using Aether without Omarchy |
| Troubleshooting | Common issues |
- omarchy-theme-hook - A clean solution to extend your Omarchy theme to other apps.
See CLAUDE.md for architecture details.
MIT - Created by Bjarne Overli