Skip to content

03 Configuration

Jump to bottom
Mrcuve0 edited this page Sep 5, 2020 · 5 revisions

LightHouse: Configuration

Preparing the main script

Once downloaded, probably the first step you have to do is to give LightHouse permission to execute. To do that open a terminal, reach the same folder where the file is located and issue the following command:

chmod +x LighHouse.py

The LightHouse.py script can now be launched by simply issuing the following command from terminal: ./LightHouse.py. The script will issue a system notification and an error message on terminal: we must specify some arguments on the command line!

How to correctly launch the script

The script needs to be feeded with some arguments indicating, for example, the names of the themes to be applied and/or the name of the wallpaper to be applied.

The following man page can be obtained by running ./LightHouse.py --help:

--- LightHouse Help Page ---

        -h,     --help:                                 Open this help page
        -p,     --plasma = PLASMA_GLOBAL_THEME:         Apply Plasma Global Theme
        -g,     --gtk = GTK_THEME:                      Apply GTKTheme
        -w=,    --wallpaper = WALLPAPER:                Apply Wallpaper (indicate /path/to/file)
        -k,     --konsole = KONSOLE_PROFILE:            Apply Konsole Profile

--- LightHouse Help Page ---

All the arguments can be optional, providing a good degree of freedom for the end user. At least one argument, however, should be provided: no modification is done to the system otherwise!

Here a deeper explanation for the UPPERCASE arguments above:

<PLASMA_THEME_NAME>  : corresponds to the name of the `Global Theme` you want to be applied (see next section)
<GTK_THEME>          : corresponds to the name of the GTK3 theme you want to be applied
<WALLPAPER>          : corresponds to the path (and filename) pointing to the file you want to be applied (see example below)
<KONSOLE_PROFILE>    : corresponds to the name of the `Konsole` profile you want to be applied

What is the correct name of the Global Theme I want to apply?

To check what is the correct name to be passed as an argument to LightHouse please enter the following command on a terminal:

kpackagetool5 --type=Plasma/LookAndFeel --list

The command will return the full list of all the Global Themes you have installed: check if your theme appears in the list.

If it appears, then you now have the official name of the theme, to be passed as a command line argument to LightHouse.

If it doesn't appear on the list, then you'll probably have to reinstall again the theme as explained in the Themes and Dependencies section of this Wiki.

Examples

WARNING! Since all the arguments are optional, all the following example configurations are valid:

  • Changing only Plasma Global Theme and GTK Theme

./LightHouse.py -p Aritim-Dark_DEV -g Aritim-Dark-GTK

  • Changing only the Wallpaper

./LightHouse.py -w /path/to/wallpaper/with/filename

  • Changing only the Konsole Profile

./LightHouse.py -k Aritim-Light_DEV

  • As a final example, I'll show you the configuration I use every day:

Light Theme Configuration

Assuming the following:

  • Aritim-Light_DEV is the name of the Global Theme I want to apply (what we previously called <PLASMA_GLOBAL_THEME>)
  • Aritim-Light-GTK is the name of the GTK3 theme I want to apply (what we previously called <GTK_THEME>)
  • /home/$USER/Pictures/Wallpapers/Aritim-Light_DEV/clouds2_DAY.jpg is the name and location of the wallpaper I want to apply (what we previously called <WALLPAPER>)
  • Aritim-Light_DEV is the Konsole Profile name (what we previously called <KONSOLE_PROFILE>)

This is the command needed to launch LightHouse and change all these components in a single shot:

./LightHouse.py -p Aritim-Light_DEV -g Aritim-Light-GTK -w /home/$USER/Pictures/Wallpapers/Aritim-Light_DEV/clouds2_DAY.jpg -k Aritim-Light_DEV

Dark Theme Configuration

Assuming the following:

  • Aritim-Dark_DEV is the name of the Global Theme I want to apply (what we previously called <PLASMA_THEME_NAME>)
  • Aritim-Dark-GTK is the name of the GTK3 theme I want to apply (what we previously called <GTK_THEME>)
  • /home/$USER/Pictures/Wallpapers/Aritim-Dark_DEV/sky_NIGHT2.png is the name and location of the wallpaper I want to apply (what we previously called <WALLPAPER>)
  • Aritim-Dark_DEV is the Konsole Profile name (what we previously called <KONSOLE_PROFILE>)

This is the command needed to launch LightHouse and change all these components in a single shot:

./LightHouse.py -p Aritim-Dark_DEV -g Aritim-Dark-GTK -w /home/$USER/Pictures/Wallpapers/Aritim-Dark_DEV/sky_NIGHT2.png -k Aritim-Dark_DEV

Clone this wiki locally