Transform your Linux and COSMIC workspace with fluid animated backgrounds, dynamic desktop color matching, and zero lag when gaming.
Run this single command in your terminal to install or update Aura with its video engine bundled:
curl -fsSL https://raw.githubusercontent.com/antwny/aura/main/install.sh | bashNative Rust performance for CachyOS, Arch Linux, Pop!_OS, Fedora, openSUSE, and any distribution running COSMIC Desktop.
๐ก Prerequisites for live video playback & video thumbnails:
- CachyOS / Arch Linux:
sudo pacman -S --needed mpv ffmpeg- Pop!_OS / Ubuntu / Debian:
sudo apt install -y libmpv2 ffmpeg- Fedora:
sudo dnf install -y mpv-libs ffmpeg-free- openSUSE:
sudo zypper install -y mpv ffmpeg
Live recording: COSMIC Desktop โข Wayland Layer-Shell โข Seamless MPV IPC Engine โ click the image to play
In the past, running animated wallpapers on Linux meant dealing with clunky background scripts that drained your laptop battery and made games stutter.
Aura changes everything. Engineered in native compiled Rust for Wayland and COSMIC, it delivers smooth 60 FPS animations when viewing your desktop, and automatically freezes to 0% CPU / 0% GPU the instant you play a game or open a window.
No need to scour the web for compatible video clips. Browse and download thousands of stunning wallpapers directly within the app:
- MotionBGS Live Wallpapers: High-quality curated video loops in both 4K and 1080p with real-time download progress tracking and instant preview.
- Wallhaven UHD: Endless collection of crisp 4K & 8K static artwork, landscapes, and anime backgrounds.
- Bing Daily Wallpaper: Automatically fetch Microsoft Bing's daily high-resolution landscape photo.
- DenverCoder1 Minimalist Flat Art: Elegant vector landscapes and illustrations that look clean on any setup.
- Category Filters & Instant Search: Filter by Anime, Nature, Sci-Fi, Cyberpunk, Gaming, Minimalist, or search by keywords in real time.
Bring your entire desktop into harmony. Aura automatically analyzes the colors in your active video or static wallpaper and adapts your entire COSMIC Desktop theme in real time:
- Harmonized Accents: Window borders, buttons, highlights, and system toggles dynamically shift to match your background's palette.
- Intelligent Contrast: Automatically computes WCAG-compliant text contrast for readability.
- Auto Light / Dark Adaptation: Shifts theme tone according to the ambiance of the wallpaper.
- Instant Unixporn Ricing: Get a cohesive desktop aesthetic without spending hours editing configuration files.
Switch wallpapers without interrupting your focus. Summon a floating heads-up display overlay anywhere on your desktop with a global shortcut (aura switcher):
Live recording: Floating Quick Switcher HUD on COSMIC Wayland โข 4 dock screen positions โ click image to watch full 60 FPS video
- Global Shortcut Summon: Bind
aura switcherin COSMIC Settings toSuper+Alt+W(or your preferred shortcut) for instant desktop access. - 4 Screen Placements: Dock the floating HUD at the Top, Bottom, or as a sleek vertical sidebar on the Left or Right screen edges.
- Fluid Keyboard & Mouse Navigation: Cycle seamlessly with Arrow Keys,
WASD, or your mouse scroll wheel. - 1-Click Apply: Click any wallpaper card in the carousel to apply it immediately and auto-dismiss.
- Zero-Flicker Native Compositing: Engineered with the Wayland Layer-Shell protocol (
Layer::Overlay) featuring exclusive keyboard focus and instant outside-click dismissal. - In-HUD Shortcuts: Toggle Pause/Resume with Space, toggle Favorites with F, or dismiss with Esc.
Have dual monitors or an ultrawide setup? Aura gives you complete independent control over every display:
- Independent Wallpapers: Assign different live videos or static images to each monitor.
- Per-Screen Scaling: Choose between Fit (letterbox), Fill (zoom crop), or Stretch individually.
- Live Canvas Visualizer: See a proportional representation of your physical monitor arrangement.
- Hotplug Detection: Seamlessly detects connected or disconnected monitors on the fly.
Independent video playback per monitor with zero tearing
The biggest concern with live wallpapers is performance. Aura solves this completely:
- Window Occlusion Detection (
-p): When any application window covers your desktop, Aura automatically halts rendering to save power. - Fullscreen Game Detection: Launches Steam games or full-screen apps with zero frame drops. 100% of your GPU and CPU remain dedicated to your game.
- Battery Saver Mode: Automatically switches to ultra-low-power mode or pauses animation when your laptop is unplugged.
- Real-Time Volume & Audio Mute: Enjoy live wallpapers with atmospheric soundtracks, adjust volume with a slider, or mute them anytime with a single click.
Control Aura seamlessly with global keyboard shortcuts. Open COSMIC Settings โ Keyboard โ Custom Shortcuts and assign your favorite key combinations:
| Action | Command | Recommended Shortcut |
|---|---|---|
| Next Wallpaper | aura next |
Super + W |
| Previous Wallpaper | aura prev |
Super + Shift + W |
| Pause / Resume (0% GPU) | aura toggle-pause |
Super + P |
| Apply Video Directly | aura apply /path/to/video.mp4 |
Right-click in file manager |
| Stop Wallpaper | aura stop |
Custom script / shortcut |
| System Status | aura status |
Terminal check |
| Update Aura | aura update |
Automatic in-app update |
Install Aura and its bundled video engine in a single step:
curl -fsSL https://raw.githubusercontent.com/antwny/aura/main/install.sh | bashTip: To install system-wide (
/usr/localwith sudo), pass--system:curl -fsSL https://raw.githubusercontent.com/antwny/aura/main/install.sh | bash -s -- --system
- Download
aura-v1.4.0-x86_64-linux.tar.gzfrom GitHub Releases. - Extract the archive and run the installer:
tar -xzf aura-v1.4.0-x86_64-linux.tar.gz
cd aura-v1.4.0-x86_64-linux
./install.shTo uninstall at any time:
./uninstall.shBuild and run in an isolated sandbox using Flatpak:
git clone https://github.com/antwny/aura.git
cd aura
flatpak run org.flatpak.Builder --user --install --force-clean build-dir packaging/flatpak/io.github.antwny.aura.yml
flatpak run io.github.antwny.auraRequirements: cargo, just, pkg-config, libwayland-dev, libxkbcommon-dev.
git clone https://github.com/antwny/aura.git
cd aura
just build
just install
auraTested on Linux with COSMIC Desktop (AMD Ryzen 5 4500U, Radeon Graphics, Wayland Layer-Shell):
| Benchmark | Aura (Compiled Rust) | Legacy Python/GTK Tools | Advantage |
|---|---|---|---|
| Cold Startup Time | < 20 ms | ~1,120 ms | 56x faster |
| RAM Footprint | Minimal native footprint | ~220 MB | Lightweight |
| Idle CPU (Paused/Occluded) | 0.00% | 3.5% - 8.0% | Zero battery drain |
| GPU Usage When Paused | 0.0% (Hardware halted) | 4.0% - 10.0% | 100% GPU for games |
| Desktop UI Framerate | Smooth 60+ FPS | 24 - 45 FPS | Silky smooth |
If Aura makes your desktop look awesome, please consider:
- Giving the repository a Star on GitHub โญ!
- Donating via PayPal to support ongoing development, optimizations, and new features.
Aura is proudly Free & Open Source software licensed under the GNU General Public License v3.0 (GPL-3.0). See LICENSE for details.



