A daemon which manages your desktop wallpapers. Sort of the 'mpd' of wallpapers.
Project description
Wallpaper Changing Daemon (wcd)
Wallpaper Changing Daemon reminds me of mpd, but it manages wallpapers instead of music.
Overview
- It comes with wcc too, which is a CLI client app, used to interact with the Daemon.
- It works on python 3.9 (and, probably, on 3.7 and 3.8 too, not sure about lower versions though).
- It only depends on
PyYAML
andcoloredlogs
, but you don't have to worry about installing them manually, pip's got you covered. - It copies it's default config file into
~/.config/wcd/
, or to wherever you point it to, via$WCD_CFG
. - I only code as a hobby, but I'd say I made a good job to make this very readable and, thus, feel very welcomed to check how things are implemented, to get a better understanding of what this program does, its capabilities, etc...
- You need to have a program which will do the wallpaper switching (such as
xwallpaper
,feh
ornitrogen
) installed on your machine.
Why shouldn't I just use a shell script instead
Lots of people use shell scripts in which they have shell scripts like this:
while true; do
for file in "$(find /usr/share/backgrounds/ -type f | shuf)"; do
xwallpaper --zoom "$file"
done
done
And that's fine, but I don't like that approach because it's too limiting. What if, actually, you don't like a wallpaper that has been presented to you? Well, then, you'd have to manually change it. With wcd and wcc, you can interact with the daemon as it presents wallpapers to you, going back and forward in a history buffer, choosing to start or to stop randomizing wallpapers, or just getting the next one presented to you if you don't like the current one anymore, all with a single keypress (see "sxhkd keybindings for wcc" below).
Installation
- Install the package with pipx:
pipx install wcd
or clone this repo and runsetup.py
- If you use Arch based distros, you can install pipx as such:
sudo pacman -S python-pipx
- If you use Arch based distros, you can install pipx as such:
- Run the package once, to generate config files. If you want to, you can point to where you want your config to be stored in by exporting an evironment variable named
WCD_CFG
, like this:export WCD_CFG="path/to/config" # be sure to add this line to your ~/.profile or ~/.bashrc or whatever shell you use
wcd
- Load the config file (defaults to
~/.config/wcd/cfg.yml
) on your text editor and change thewallpaper_cmd
entry to whatever suits you best. - Kill the previous running instance if you haven't already and, then, restart the program.
- You're all set, enjoy.
Installing and Running as systemd Service
- Clone this repo:
git clone https://github.com/brunofauth/wcd.git
- cd into it:
cd wcd
- edit
wcd.service
to include whatever you get when you runwhich wcd
- Copy the unit file to your systemd config folder:
cp wcd.service ~/.config/systemd/user/wcd.service
- To enable starting wcd on login, run:
systemctl enable --user wcd.service
- To immediatly start wcd, run:
systemctl start --user wcd.service
Communicating with the wcd
- Run:
wcc --help
, it stands for Wallpaper Changing Client and comes bundled withwcd
sxhkd keybindings for wcc (append to your sxhkdrc)
shift + XF86Audio{Play,Next,Prev}
wcc {toggle_cycle,next,prev}
TODO
- aur package
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file wcd-0.0.0a5.tar.gz
.
File metadata
- Download URL: wcd-0.0.0a5.tar.gz
- Upload date:
- Size: 10.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e311c11a372e0de8592d8cf61f112f38fd8c6da70c103ffd943779dceabb6c47 |
|
MD5 | 9c6d9848a3767f9b809883ce34d243f9 |
|
BLAKE2b-256 | d2b919aefddebd179f0ad36bf0db97299a3ac1bdfecd2824f2878616f47e712b |
File details
Details for the file wcd-0.0.0a5-py3-none-any.whl
.
File metadata
- Download URL: wcd-0.0.0a5-py3-none-any.whl
- Upload date:
- Size: 10.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6f49363dd193636b1c020fdbe8d1f0ce737bc5a91abf8df4d191debd5ca6227d |
|
MD5 | a4bb63e3f6d6a52f2f92f0329d8ca6de |
|
BLAKE2b-256 | 5496ab00ba99a5dedf5c8a2b49f1afc887814915222d1b1acc70a66982bc03f5 |