Aether stores files in three standard XDG directories.
User settings and persistent data.
~/.config/aether/
├── blueprints/ # Saved theme blueprints
│ └── *.json # Individual blueprint files
├── custom/ # Custom app templates
│ └── appname/ # One folder per app
│ └── template.ext # Template files with color variables
├── theme/ # Generated theme output
│ ├── backgrounds/ # Wallpaper copies
│ └── *.conf # Processed config files
├── favorites.json # Favorited wallpapers list
├── settings.json # App preferences
└── wallhaven.json # Wallhaven API key and settings
| File | Purpose |
|---|---|
blueprints/*.json |
Saved color schemes with wallpaper reference |
settings.json |
Light mode, template toggles, adjustments |
wallhaven.json |
API key for NSFW content access |
favorites.json |
List of favorited wallpaper paths/URLs |
Temporary and regeneratable files.
~/.cache/aether/
├── thumbnails/ # Local wallpaper thumbnails
├── wallhaven-thumbs/ # Wallhaven preview images
├── color-cache/ # Extracted color palettes
└── processed-wallpaper-*.jpg # Edited wallpapers
These files can be safely deleted to free disk space.
Permanent user data.
~/.local/share/aether/
└── wallpapers/ # Downloaded wallhaven wallpapers
Downloaded wallpapers are kept permanently for offline access.
When running with Omarchy, a symlink connects Aether's output:
~/.config/omarchy/themes/aether/ -> ~/.config/aether/theme/
This allows omarchy-theme-set aether to find the generated theme.
Safe to delete:
~/.cache/aether/- Thumbnails and processed images
Keep:
~/.config/aether/blueprints/- Your saved themes~/.local/share/aether/wallpapers/- Downloaded wallpapers
Reset all settings:
rm -rf ~/.config/aether ~/.cache/aether ~/.local/share/aether