A wallpaper plugin integrating wallpaper engine into kde wallpaper setting.
- Known issues:
- Some scene wallpapers may crash your KDE.
RemoveWallpaperSource
line in~/.config/plasma-org.kde.plasma.desktop-appletsrc
and restart KDE to fix. - Mouse long press (to enter panel edit mode) is broken on desktop.
- Screen Locking is not supported, please not use this plugin in screen locking.
- Some scene wallpapers may crash your KDE.
- Support scene(2d),video,web wallpaper types
- Requires Wallpaper Engine installed on steam
- Requires Python 3.3+
- Requires Qt 5.13+ for playing video(no mpv), or mpv instead
- Requires Vulkan 1.1+, Opengl External Memory Object extension
- Requires vulkan driver installed
If you are using amd, please choose RADV driver.
Debian:
sudo apt install build-essential libvulkan-dev plasma-workspace-dev gstreamer1.0-libav \
liblz4-dev libmpv-dev python3-websockets qtbase5-private-dev \
libqt5x11extras5-dev \
qml-module-qtwebchannel qml-module-qtwebsockets
Fedora:
# Please add "RPM Fusion" repo first
sudo dnf install vulkan-headers plasma-workspace-devel kf5-plasma-devel gstreamer1-libav \
lz4-devel mpv-libs-devel python3-websockets qt5-qtbase-private-devel \
qt5-qtx11extras-devel qt5-qtwebchannel-devel qt5-qtwebsockets-devel
Arch:
sudo pacman -S extra-cmake-modules plasma-framework gst-libav \
base-devel mpv python-websockets qt5-declarative qt5-websockets qt5-webchannel vulkan-headers
Void:
sudo xbps-install -S extra-cmake-modules plasma-framework \
gst-libav base-devel mpv python3-websockets qt5-declarative qt5-websockets \
qt5-webchannel plasma-workspace-devel mpv-devel liblz4-devel Vulkan-Headers
Fedora Kinoite:
see install via rpm-ostree
Still need to run commands below to get scene and mpv work.
Every time you receive update in discover, you should run these commands to update.
# Download source
git clone https://github.com/catsout/wallpaper-engine-kde-plugin.git
cd wallpaper-engine-kde-plugin
# Download submodule (glslang)
git submodule update --init
# Configure
# 'USE_PLASMAPKG=ON': using plasmapkg2 tool to install plugin
mkdir build && cd build
cmake .. -DUSE_PLASMAPKG=ON
# Build
make
# Install package (ignore if USE_PLASMAPKG=OFF for system-wide installation)
make install_pkg
# install lib
sudo make install
- remove files that list in
wallpaper-engine-kde-plugin/build/install_manifest.txt
plasmapkg2 -r ~/.local/share/plasma/wallpapers/com.github.casout.wallpaperEngineKde
- Wallpaper Engine installed on Steam
- Subscribe to some wallpapers on the Workshop
- Select the steamlibrary folder on the Wallpapers tab of this plugin
- The steamlibrary which contains the steamapps folder
- This is usually
~/.local/share/Steam
by default
- This is usually
- Wallpaper Engine needs to be installed in this steamlibrary
- The steamlibrary which contains the steamapps folder
You need to restart KDE(re-login) after reinstalling the plugin
Please not use kstart5 plasmashell
, which will cause freezing
Re-login is ok
Scene wallpapers are supported by vulkan 1.1
Requires Wallpaper Engine installed for assets(shaders,pictures...)
Only for testing and debug
Requires glfw
# git clone and init submodule
cd src/backend_scene/standalone_view
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release -DBUILD_QML=ON
make
./sceneviewer --help
argparse - Command line argument parser
stb - Image loading
miniaudio - Audio loading and playback
nlohmann/json - Json parsing
Eigen - Math operations
glad - Opengl loader
glslang - Glsl to Spv
Vulkan-Hpp - Vulkan C++ API
VulkanMemoryAllocator - Vulkan memory allocation library
- Layer
- Image
- Composition / Fullscreen
- Text
- Effect
- Mouse position with delay
- Parallax
- Depth Parallax
- ColorBlendMode
- PBR light
- Global bloom
- Camera
- Zoom
- Shake
- Fade / Path
- Audio
- Loop
- Random
- Visualization
- Particle System
- Renderers
- Emitters
- Duration
- Initializers
- Operators
- Control Point Force
- Vortex
- Control Points
- Children
- Puppet warp
- 3D model
- Timeline animations
- Scenescript
- User Properties
Basic web apis are supported, but the audio api does not send data for now.
WebEngineView in plasmashell can't init opengl.
Some wallpaper using webgl may not work, and performance may be bad.
The default video backend of this plugin.
It's using GStreamer to play video.
hwdecode for GStreamer
Need to compile the plugin lib.
The config is set to hwdec=auto
, and is not configurable for now.
There is no general way. If there is a way to have good support for most desktop environments, why not we just require wallpaper engine itself to support linux. Some similar apps like lively and ScreenPlay can benefit from that, but that way doesn't exist. Actually the integration and implement are separated, for all integration ways, the implement is shared. So if there is a general way, we can move to it easily.
The major work of this plugin is the scene wallpaper renderer. If you want to integrate this into other desktop environments, here are some examples. Currently this renderer is rendering under vulkan and sharing to opengl texture which will be read by qml(plasmashell) in kde. You can integrate this renderer into anything that can show vulkan or opengl textures.
- RePKG
- RenderDoc
- NVIDIA Nsight Graphics
- learnopengl.com
- SaschaWillems/Vulkan
- All the open-source libraries mentioned above