Skip to content
athersic64Public
forked from antwny/aura

About

A native Rust live wallpaper manager for COSMIC Desktop. Smooth animated wallpapers, dynamic desktop theming, multi-monitor support, and smart performance controls for Linux.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

ย 
ย 

Latest commit

ย 

History

103 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Aura Logo

Aura

Alive wallpapers for Linux. Built for the modern desktop.

Transform your Linux and COSMIC workspace with fluid animated backgrounds, dynamic desktop color matching, and zero lag when gaming.

Release COSMIC Desktop Wayland Native Smart Pause Open Source Donate


โšก Quick Install (Ready in 30 seconds)

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 | bash

Native 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

Animated preview of the Aura showcase โ€” click to play the full video

Live recording: COSMIC Desktop โ€ข Wayland Layer-Shell โ€ข Seamless MPV IPC Engine โ€” click the image to play




โœจ Why You'll Love Aura

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.


๐Ÿ”ฅ Thousands of Free Live & 4K Wallpapers Built-In

No need to scour the web for compatible video clips. Browse and download thousands of stunning wallpapers directly within the app:

Aura Online Catalogs

  • 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.

๐ŸŽจ Magic Desktop Auto-Theming

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:

Aura Dynamic Auto-Theming

  • 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.

โšก Quick Switcher HUD: Instant Desktop Overlay

Switch wallpapers without interrupting your focus. Summon a floating heads-up display overlay anywhere on your desktop with a global shortcut (aura switcher):

Aura Quick Switcher HUD Demo

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 switcher in COSMIC Settings to Super+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.

๐Ÿ–ฅ๏ธ Multi-Screen Studio

Have dual monitors or an ultrawide setup? Aura gives you complete independent control over every display:

Aura Multi-Monitor Visualizer

  • 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


๐ŸŽฎ Smart Auto-Pause: 0% GPU & CPU in Games

The biggest concern with live wallpapers is performance. Aura solves this completely:

Aura Performance Settings

  • 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.

โŒจ๏ธ Effortless Control & Keyboard Shortcuts

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

๐Ÿš€ Installation Options

Method 1: One-Line Web Installer (Fastest & Recommended)

Install Aura and its bundled video engine in a single step:

curl -fsSL https://raw.githubusercontent.com/antwny/aura/main/install.sh | bash

Tip: To install system-wide (/usr/local with sudo), pass --system:

curl -fsSL https://raw.githubusercontent.com/antwny/aura/main/install.sh | bash -s -- --system

Method 2: Precompiled Release Package

  1. Download aura-v1.4.0-x86_64-linux.tar.gz from GitHub Releases.
  2. 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.sh

To uninstall at any time:

./uninstall.sh

Method 3: Flatpak Package

Build 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.aura

Method 4: Build from Source (Rust Developers)

Requirements: cargo, just, pkg-config, libwayland-dev, libxkbcommon-dev.

git clone https://github.com/antwny/aura.git
cd aura
just build
just install
aura

๐Ÿ“Š Performance Benchmarks

Tested 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

๐Ÿ’ฌ Community & Support

Support the Project โญ

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.

๐Ÿ“œ License

Aura is proudly Free & Open Source software licensed under the GNU General Public License v3.0 (GPL-3.0). See LICENSE for details.

Crafted with passion for the COSMIC Desktop, Linux, and Wayland community.

About

A native Rust live wallpaper manager for COSMIC Desktop. Smooth animated wallpapers, dynamic desktop theming, multi-monitor support, and smart performance controls for Linux.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages