✦ LINUX WALLPAPER ENGINE GUI ✦

◈ A graphical user interface for managing wallpapers on Linux ◈
◈ Powered by Go (Backend) and Electron (Frontend) ◈

CONTENTS

• CONTENTS
• SCREENSHOTS
• FEATURES
• MEMORY EFFICIENCY
• PREREQUISITES
• INSTALLATION
  • Arch Linux (AUR)
  • Other Distributions
• USAGE
  • [Options]
• BUILD FROM SOURCE
• DEVELOPMENT
• CONTRIBUTING
• STONKS!

[!NOTE] This GUI will be compatible with my linux-wallpaperengine in the future.

It's a Go implementation of Wallpaper Engine for Linux. It's still in early development. Maybe you want to check it out!

SCREENSHOTS

FEATURES

• Wallpaper Management – Browse and select wallpapers from your Steam Workshop content with ease.
• Steam Workshop Integration – Search and download wallpapers directly from the Steam Workshop (requires steam running on background).
• Playlist Support – Create and manage playlists, including a dynamic "Random All" playlist that automatically includes all your wallpapers.
• Wallpaper Properties – Adjust individual wallpaper settings.
• Multi-Monitor Support – Effortlessly choose which screen to apply wallpapers.
• Auto-Save & Auto-Run – Remembers your last used wallpaper and applies it automatically on startup.
• Native Wayland Support – Optional native Wayland mode for fix scaling issues on Wayland sessions.
• Customizable Settings – Edit settings for linux-wallpaperengine, or edit raw JSON config.
• System Tray – Minimize to the tray for seamless background operation without cluttering your workspace.

MEMORY EFFICIENCY

I know that many users are scared of Electron applications due to their reputation for being "RAM eaters". This GUI is specifically designed for maximum efficiency to address those concerns:

• Go Backend: A lightweight Go process handles the system tray, configuration, and wallpaper management.
• Electron Frontend: The Electron-based UI is only launched when needed. When you minimize the application to the tray, the Electron process is completely terminated, freeing up all the memory it was using.

PREREQUISITES

[!IMPORTANT] This application requires linux-wallpaperengine to be installed on your system to function.

INSTALLATION

Arch Linux (AUR)

Install using your favorite AUR helper:

# Using yay
yay -S linux-wallpaperengine-gui-git

# Using paru
paru -S linux-wallpaperengine-gui-git

Other Distributions

Download the latest pre-built binaries (AppImage, deb, rpm) from the Releases page.

USAGE

Launch it from your application menu or via terminal:

linux-wallpaperengine-gui [options]

[Options]

• --minimized: Starts the application minimized in the system tray.
• --native-wayland: Makes electron use native Wayland instead of XWayland to solve fractional scaling issues (only works on Wayland sessions)
• --debug-mode: Enables debug mode for the application.

BUILD FROM SOURCE

Requirements:

• Go (1.21+)
• bun

1. Clone & Enter:

   git clone https://github.com/AzPepoze/linux-wallpaperengine-gui
   cd linux-wallpaperengine-gui
   

2. Install Deps:

   bun install
   

3. Build:

   bun run build
   

   The output will be in the dist directory.

DEVELOPMENT

Run with hot-reloading:

bun run dev

CONTRIBUTING

Feel free to contribute to this project by opening issues or submitting pull requests.

[!IMPORTANT] Please make sure to select the dev branch when submitting pull requests.

STONKS!

✦ Made with ♥︎ by AzPepoze ✦