https://github.com/smooll-d/smoollwallpaper

SmoollWallpaper (swall) is a simple Python script for setting video wallpapers on Linux.
https://github.com/smooll-d/smoollwallpaper

linux live-wallpaper python python3 video-wallpaper wallpaper x11 xlib

Last synced: about 1 month ago
JSON representation

SmoollWallpaper (swall) is a simple Python script for setting video wallpapers on Linux.

• Host: GitHub
• URL: https://github.com/smooll-d/smoollwallpaper
• Owner: smooll-d
• License: mit
• Created: 2022-08-31T12:20:14.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2023-12-18T04:28:40.000Z (about 1 year ago)
• Last Synced: 2024-09-08T21:04:06.827Z (4 months ago)
• Topics: linux, live-wallpaper, python, python3, video-wallpaper, wallpaper, x11, xlib
• Language: Python
• Homepage:
• Size: 183 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# SmoollWallpaper

SmoollWallpaper (swall) is a simple Python script for setting video wallpapers on Linux.

***



	

		

	

	

		

	

	

		

	

	

		

	





	

		

	

	

		

	

	

		

	

	

		

	

	

		

	

	

		

	

	

		

	



***

## Overview

SmoollWallpaper uses the magic of `mpv` and `xwinwrap` to display animated (or just video) wallpapers on your desktop, and with the help of `xprop` it allows the wallpapers to stop when you click on another window than your desktop, if you're PC or laptop don't have the best of specs just like me :).

It also allows using images as wallpapers, but this option is `WIP` (Work In Progress) and only available for `GNOME`, `LXDE/PCmanFM`, `LXQt/PCmanFM-qt` and `KDE >=5.7`, although I don't know about KDE because I haven't tested it yet, but if you'd like to contribute to this project, you can test it out and let me know by opening an issue.

If you'd like to get started on using my magnum opus ('cause let's be honest, I will probably never make something better), you can go to the [Getting Started wiki page](https://www.github.com/reallySmooll/smoollwallpaper/wiki/Getting-Started) or you can click on one of the badges above that says `GETTING STARTED`. There's a normal wallpaper version as well. You can go [here](https://www.github.com/reallySmooll/smoollwallpaper/wiki/Getting-Started-(Normal-Wallpapers)) or you can click on the `GETTING STARTED (NORMAL WALLPAPERS)` badge above.

Happy desktop customization! :D

And btw, the security scans are passing: [![Codacy Security Scan](https://github.com/reallySmooll/smoollwallpaper/actions/workflows/codacy.yml/badge.svg?branch=master)](https://github.com/reallySmooll/smoollwallpaper/actions/workflows/codacy.yml)

***

## Features

- Video wallpapers

- Script pauses automatically if desktop is not focused

- Option to not pause the script automatically when the desktop is not focused

- Normal wallpapers (desktops supported):

	- GNOME

	- KDE >=5.7 (currently not available)

	- LXDE/PCmanFM

	- LXQt/PCmanFM-qt

## Upcoming features (hopefully)

- Graphical interface

- Command line interface

I will come up with more features in the future :)

***

### NOTE: THIS SCRIPT ONLY WORKS ON LINUX (X11)