https://github.com/filipporanza/theme_changer
Automatically change your wallpaper folder on KDE desktop
https://github.com/filipporanza/theme_changer
desktop-automation desktop-wallpaper kde kde-desktop kde-plasma-5 linux python-3 python3 wallpaper wallpaper-changer yaml
Last synced: 3 months ago
JSON representation
Automatically change your wallpaper folder on KDE desktop
- Host: GitHub
- URL: https://github.com/filipporanza/theme_changer
- Owner: FilippoRanza
- License: gpl-3.0
- Created: 2018-11-11T21:35:47.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2019-04-19T18:21:04.000Z (over 6 years ago)
- Last Synced: 2025-04-15T01:47:41.371Z (6 months ago)
- Topics: desktop-automation, desktop-wallpaper, kde, kde-desktop, kde-plasma-5, linux, python-3, python3, wallpaper, wallpaper-changer, yaml
- Language: Python
- Size: 49.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# theme_changer.py [](https://travis-ci.com/FilippoRanza/theme_changer) [](https://www.codacy.com/app/FilippoRanza/theme_changer?utm_source=github.com&utm_medium=referral&utm_content=FilippoRanza/theme_changer&utm_campaign=Badge_Grade)
Automatically change your wallpaper folder on KDE desktop
## Installation
To install this script you have to run, with root privileges,
*setup.py install* using python3.
```commandline
[sudo] python[3] setup.py install
```
### Requirements
```commandline
Python 3
PyYAML
```
All those requirements are checked and satisfied by setup.py
### Configuration
In order to work properly *theme_changer.py* need a correct configuration
1. Create a directory named *'.wallpapers'* in your home directory.
You can place your wallpaper collection here or anywhere else.
2. Create a file named *'config.yml'* in *~/.wallpapers*
3. Fill your configuration file your *seasons*
4. Create a softlink named *'current'* in *~/.wallpapers*. This link should target
your current wallpaper directory
5. Configure KDE to use *~/.wallpapers/current* as wallpaper location
6. Configure your desktop to autorun *theme_changer.py* at startup. No commands line arguments
are needed. For example:
```commandline
cd ~/.config/autostart-scripts
ln -s $(which theme_changer.py) theme_changer
```
#### Dynamic Reconfiguration
You can add and remove all season that you want any time you want but before it takes effect you must
logout and login to force Plasma to restart. If you run the script during the desktop execution it
will break the softlink and crash the slideshow, if this happens you just have to restart KDE(logout-login).
#### Season Configuration
A *season* is a YAML entry. It have any kind of fantasy name(but NOT 'default')
and *must* be unique. Inside each season must be present those three entries:
1. from *day-month* : defines when a season starts
2. to *day-month* : defines when a season ends
3. dir *path*: define *~/.wallpapers/current* during this season.
There can be any number of *season*, the only *mandatory* season is *default*, that define the behavior
where none of the other season matches.
Default season has just one entry:
1. dir *path*: define *~/.wallpapers/current* when none of the other season matches.
Read 'config.yml' for an example configuration.