No description
  • Python 74.6%
  • JavaScript 23.5%
  • HTML 1.9%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2025-10-29 20:00:46 +00:00
background-window Update Main.js 2025-09-16 02:33:21 +01:00
.gitignore Create .gitignore 2025-08-22 09:25:13 +01:00
LICENSE Add new file 2025-08-22 09:30:46 +01:00
Main.py add other path 2025-10-29 20:00:46 +00:00
README.md Edit README.md 2025-09-18 11:57:38 +01:00
RePKG.exe Basic 2d scene support 2025-08-22 09:13:29 +01:00
Setup.py Tweaks 2025-08-22 06:11:44 +01:00
THIRD-PARTY-NOTICES.txt Basic 2d scene support 2025-08-22 09:13:29 +01:00

HyprWallpaperEngine

A port of wallpaper engine made for hyprland on linux.

  • Requires that wallpaper engine on steam is installed at ~/.local/share/Steam/steamapps/common/wallpaper_engine
  • Automatically adds required lines to hyprland.conf when selecting a wallpaper for autostart

Supports:

  • Video
  • Web
  • Scene 2D (Very Basic, likely to break)
  • Mouse interaction

Credits:

  • RePKG for wallpaper engine package extraction tool.
  • wl-find-cursor for global cursor position.

It is assumed hyprland is already installed and configured.

Dependencies:

  • python3
  • python-pip
  • mpvpaper
  • ffmpeg
  • yay
  • wine

Python Dependencies:

  • InquirerPy

Installation (Arch Linux)

Install dependencies: sudo pacman -S python3 python-pip mpvpaper ffmpeg wine | yay -S mpvpaper

Clone repository

cd ~
git clone https://gitlab.bracketproto.com/BracketProto/hyprwallpaperengine

Install python dependencies

cd ~/hyprwallpaperengine/
pip install inquirerpy 

Running & Usage

Run using python3 ./Main.py [mpv arguments] to open up wallpaper selection menu or python3 ./Main.py [steamid] [mpv arguments] to select a specific wallpaper via steam id

Flags

  • --web - Forces video to run as a 'web' wallpaper (uses chromium instead of mpvpaper)
  • --muted - Forces a wallpaper to run as muted
  • --volume=[value] Forces a web wallpaper to use a specific volume on play