🌌 OMYWALL - Universal Wayland Wallpaper Engine

Ultra-Lightweight, Hardware-Accelerated Video, Web 3D & Desktop Wallpaper Engine for Linux Wayland

---

📖 About

OMYWALL (omywall) is an ultra-lightweight, hardware-accelerated live video, web stream, and desktop wallpaper engine for Linux Wayland compositors. Built with Rust, native wlr-layer-shell (mpvpaper & GTK Layer Shell + WebKit2), libmpv, Ratatui, and egui, it renders high-performance desktop background videos and live WebGL 3D wallpapers natively behind all windows on every workspace with minimal CPU (~1-2%) and RAM overhead.

---

✨ Key Features & Capabilities

• 🎥 Wayland wlr-layer-shell Video Engine: Video wallpapers (.mp4, .mkv, .webm, .gif) attach natively to the desktop background layer using mpvpaper. Never spawns floating or fullscreen overlay windows above active apps.
• 💚 NVIDIA PRIME / CUDA Hardware Acceleration: Automatic GPU offload (__NV_PRIME_RENDER_OFFLOAD=1, nvdec, cuda) for 4K 60FPS video playback and WebGL 3D rendering directly on discrete NVIDIA GPUs.
• 🌐 Native wlr-layer-shell Web Engine: Websites, HTML5 WebGL 3D animations, and interactive mouse-follower particles render as true wlr-layer-shell background surfaces using native GTK Layer Shell and WebKit2.
• 🖤 OLED Interactive Wallpapers: Specially crafted pitch-black #000000 canvas wallpapers with interactive liquid fluid mouse-following particle physics.
• 🔒 Hyprlock Screensaver Integration: Attach any video, image, or Web 3D wallpaper directly as your hyprlock screensaver background with auto-extracted frame thumbnails.
• ⚡ ANR-Free Non-Blocking Architecture: All Unix socket IPC network requests and daemon polling run on isolated background threads, guaranteeing the UI event loop never freezes or triggers OS "Application Not Responding" warnings.
• 🎨 Modern Cyberpunk egui Desktop GUI: High-tech desktop control panel with live hero previews, media inspector, and hardware decoder selector.
• ⌨️ Keyboard-Driven Terminal UI (Ratatui): Fast, lightweight TUI for terminal aficionados with rounded neon borders and instant keybindings.

---

📦 Installation Guide

🔷 Arch Linux (AUR)

# Install via AUR helper (yay / paru)
yay -S omywall-git

# Or build manually with makepkg
git clone https://github.com/MISTERNEGATIVE21/omywall.git
cd omywall
makepkg -si

⚡ Quick Install Script (Any Linux Distribution)

git clone https://github.com/MISTERNEGATIVE21/omywall.git
cd omywall
bash install.sh

---

🎮 Usage & Commands

🖥 Launching Interfaces

# Launch Graphical Desktop GUI
omywall gui

# Launch Interactive Terminal UI (TUI)
omywall tui

# Start background wallpaper daemon
omywall daemon

🚀 CLI Quick Commands

# Set a video or HTML wallpaper
omywall set ~/Pictures/Wallpapers/cyberpunk_city.mp4
omywall set assets/web_wallpapers/neon_oled_fluid_mouse_3d.html

# Stream a web URL
omywall set-url "https://html5test.com"

# Playback controls
omywall pause
omywall resume
omywall toggle
omywall clear

# Enable automated slideshow (300 seconds interval)
omywall slideshow --interval 300 --shuffle

---

⚙️ Configuration (~/.config/omywall/config.toml)

wallpaper_dir = "/home/user/Pictures/Wallpapers"
socket_path = "/run/user/1000/omywall.sock"
hwdec = "auto" # Hardware Decoder: "auto", "nvdec", "cuda", "vaapi", "vulkan", "no"
volume = 0
mute = true
screen_id = 0
target_fps = 60
opacity = 1.0
slideshow_interval = 300
slideshow_shuffle = false

[hyprlock]
enabled = true
background_path = ""
blur_passes = 3
blur_size = 8
clock_color = "rgba(0, 240, 255, 1.0)"
clock_size = 64
welcome_message = "Welcome back, $USER"

---

📜 License

Licensed under the MIT License. Built with ❤️ for Linux Wayland users.