🌸 WaifuPaper 🌸

A modern, cross-platform live wallpaper application that displays random high-quality anime wallpapers from Konachan directly on your desktop.

Preview

Contents

• Features
• Installation & Usage
  • Linux
  • Windows
• Development & Building
• Acknowledgments

Features

• Cross-Platform: Native support for Linux (Wayland/GTK4) and Windows (WinForms/WebView2).
• Interactive UI: Smooth crossfade transitions and a modern "Random" button with backdrop blur.
• System Tray: Minimal footprint with a system tray icon for easy exit.
• Lightweight: Low resource usage, serving content via a local embedded proxy.

Installation & Usage

Linux (Wayland)

Requires GTK4, WebKitGTK, and gtk4-layer-shell. These dependencies must be installed via your system's package manager.

Example (Arch Linux):

sudo pacman -S gtk4 webkitgtk-6.0 gtk4-layer-shell libayatana-appindicator python-gobject

Note: For other distributions, please find the equivalent packages (e.g., libgtk-4-dev, libwebkit2gtk-4.1-dev on Debian/Ubuntu).

1. Download the latest waifupaper_v*_linux.zip from the Releases page.
2. Extract the archive.
3. Run the launcher:

   ./waifupaper.sh

Windows

1. Download the latest waifupaper_v*_windows.zip from the Releases page.
2. Extract and run WaifuPaper.exe.

Prerequisites (Windows Build)

To build this project on Windows, you need to install the following:

• Node.js
• pnpm
• Python 3 (Make sure to check "Add Python to PATH" during installation)
• .NET 8.0 SDK

Build Instructions

Run the build script from the project root:

python build.py

The output will be located in the release/ folder.

Development

1. Install Python Dependencies:

   pip install -r requirements.txt

2. Run Auto-Dev System:

   python dev.py

Acknowledgments

• Wallpapers provided by Konachan.