✦ LINUX WALLPAPER ENGINE GUI ✦

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

CONTENTS

• CONTENTS
• FEATURES
• MEMORY EFFICIENCY
• SCREENSHOTS
• 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!

FEATURES

• Wallpaper Management – Browse and select wallpapers from your Steam Workshop content with ease.
• 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.
• 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.

SCREENSHOTS

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.
• --debug-mode: Enables debug mode for the application.

BUILD FROM SOURCE

Requirements:

• Go (1.21+)
• Node.js & pnpm

1. Clone & Enter:

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

2. Install Deps:

   pnpm install
   

3. Build:

   pnpm run build
   

   The output will be in the dist directory.

DEVELOPMENT

Run with hot-reloading:

pnpm run dev

CONTRIBUTING

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

STONKS!

✦ Made with ♥︎ by AzPepoze ✦