hack3rmann/waywe-rs
hack3rmann/waywe-rs has 46 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-15 15:13 UTC. Last push 2026-10-11.
What you can do
- Image wallpapers in various formats.
- Video wallpapers in .mp4 (h.264 and h.265 -encoded formats)
- Configurable transition animations.
- Custom scene wallpapers packaged as .ww archives (shared library + assets).
Measured star growth
- in 24h
- 0
- in 7 days
- Update delayed
- in 15 days
- Update delayed
- in 1 month
- Update delayed
Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.
About
Wallpaper engine built for Wayland written in Rust.
Creative & MediaREADME.md
OriginalBlazingly Fast Video Wallpapers in Rust
Highly efficient wallpaper software with no overhead
waywestands for 'Wayland Wallpaper Engine'
https://github.com/user-attachments/assets/48a8b135-bbf2-4055-8453-19292a923939
Warning
- This software is still in development, some major features may be unimplemented.
- This project uses a lot of hardware-dependent code to make it work fast as F.
- Special warning for the ones who concerned about unsafe code in Rust: this project contains a lot of it and built upon it. Of course, to speed up a lot of processing code.
Available Features
- Image wallpapers in various formats.
- Video wallpapers in .mp4 (h.264 and h.265 -encoded formats)
- Configurable transition animations.
- Custom scene wallpapers packaged as
.wwarchives (shared library + assets).
Dependencies
- Modern Linux distribution.
wlroots-based Wayland compositor (e.g. Hyprland or Sway).- Support for
libvahardware acceleration.
Install
Clone the repo
git clone https://github.com/hack3rmann/waywe-rs.git --depth 1
Build
Build whole project
cd waywe-rs
cargo build --release --locked
Install
You can find both waywe and waywe-daemon executables under target/release directory:
sudo cp target/release/waywe target/release/waywe-daemon /usr/bin
Usage
Start the daemon:
waywe start
# or
waywe-daemon --run-in-background
Then use the waywe cli tool to control daemon's behavior:
waywe show path/to/your/video.mp4
waywe show path/to/your/picture.jpg
waywe show path/to/your/scene.ww
Scene wallpapers are dynamic libraries built with waywe-scene or
waywe-rendering-api (experimental), then packaged with
waywe package build so the .so and any assets/ are shipped together. See the crate
READMEs for how to author, package, and load them.
Note that it will set the same wallpaper for all currently plugged monitors.
You can also specify on which monitor to set wallpaper to with --monitor <NAME> key.
Also, you can create preview image of currently running wallpaper:
waywe preview preview.png
For other handy commands run waywe help.
Scene wallpapers
With waywe-scene, put #[derive(Scene)] on your wallpaper type —
the FFI entry point is generated for you. With waywe-rendering-api
directly, you write waywe_ffi_create_opaque_renderer yourself and implement all rendering.
Package an example scene and set it as wallpaper:
waywe package build --path crates/examples/waywe-test-scene
waywe show target/release/waywe-test-scene.ww
ShaderToy example:
waywe package build --path crates/examples/shadertoy-computer-were-made-for-cubes
waywe show target/release/shadertoy-computer-were-made-for-cubes.ww
waywe package build runs cargo build --release, bundles lib<crate>.so as wallpaper.so, and
includes every file under the crate's assets/ directory into a gzip-compressed tar
archive (.tar.gz aliased as .ww) under target/<profile>/.
Configuration
Configuration is written in Dhall language. See config docs.
Troubleshooting
This project is tested only on several machines with Intel or AMD CPUs with integrated graphics running Fedora 42/43/44.
Common issues
ERROR_FORMAT_NOT_SUPPORTED:- try install
ffmpegandlibvalibraries - try update/install your video drivers
- try install
- You have both discrete and integrated graphics:
- try
vainfo | grep Driver- it will show the current driver name. - if you are on Intel, set
LIBVA_DRIVER_NAME=iHDenvironment variable before you run the daemon. - or for AMD, set
LIBVA_DRIVER_NAME=Gallium - otherwise set it accordingly with your integrated graphics driver.
- try
Alternatives
There are already tools with quite similar features:
swww- great tool to use with picture wallpapers.swaybg- from the authors ofwlrootsprotocol.mpvpaper- play videos withmpvdirectly on your wallpaper.hyprpaper- simplest solution for Hyprland users
Acknowledgments
Special thanks to swww. waywe project is heavily inspired by swww.
Future directions
- Using Wallpaper Engine assets with
waywe.