A GNOME Shell extension that lets you set any video as your lock screen background.
⚠️ Only tested on GNOME 47-49 so far. Should work on GNOME 45+ but not guaranteed. Try at your own risk.
💡 If you experience issues, check the Debug section in preferences for workarounds.
- 🎬 Play any video file as the lock screen background
- 🔁 Loop support
- 🎨 Video scaling modes (cover, fit, stretch)
- 🔲 Transparent video support (RGBA)
- ⏸️ Auto pause/play on suspend/wake
- 🌌 Configurable fade-in animation
- 🖥️ Multiple monitor support
- 🌫️ Blur effect with adjustable radius and brightness
- 🎞️ Configurable framerate (1-120 fps)
- 🔊 Optional audio output with volume control and fade-in/out
- 🔑 Interactive changes on password prompt (blur/brightness change, video pause, etc)
- Improve performance for high-res videos
- Publish to extensions.gnome.org
-
Per-monitor video selection— not planned, single pipeline is used for performance
- Possible audio and video desync after suspend/wake
- Brief green frame at video start (enable "Skip first frame" in Debug settings to fix)
- Possible clicking/crackling sounds when pausing/playing video with audio
- Performance issues and shell crashes with high-res videos (hardware dependent)
-
Clone the repository:
git clone https://github.com/nick-redwill/LiveLockScreen.git
-
Copy to your extensions folder:
cp -r LiveLockScreen ~/.local/share/gnome-shell/extensions/live-lockscreen@nick-redwill -
Log out and back in, then enable the extension:
gnome-extensions enable live-lockscreen@nick-redwill -
Open the extension preferences and select your video file.
- GNOME Shell 47-49 (other versions untested)
- GStreamer with good/bad plugins:
# Fedora sudo dnf install gstreamer1-plugins-good gstreamer1-plugins-bad-free gstreamer1-plugins-ugly # Ubuntu/Debian sudo apt install gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly
If you enjoy this extension, consider buying me a tea 🍵 (I’m not really a coffee person :D)
AGPL-3.0
