This page includes and specifies all the configuration files installed by the script. Some of these files were created by ML4W, so you may find references to them in some of the files.

Alacritty

The default terminal emulator is Alacritty, and its configuration can be found in the ~/.config/alacritty/ folder.

Bash

The pre-defined .bashrc file is replaced by a new file that includes all the files contained in the ~/.config/bashrc folder. This setup allows you to define components such as aliases, startup commands, and more in a modular way.

IMPORTANT NOTE: Do not edit the .bashrc file directly. If you want to add something, simply create a new file or modify one of the existing ones in the ~/.config/bashrc directory.

GTK 3 and GTK 4

These libraries install both GTK 3 and GTK 4, used by various apps. You can change the style through the theme manager nwg-look or by modifying the configuration files in ~/.config/gtk-3.0. I recommend using the theme editor rather than manually editing the configuration file, as changes will only take effect after rebooting or logging out.

Dotfiles

The ~/.config/dotfiles folder contains a cache folder for temporary files (such as the blurred wallpaper used in wlogout), which generally doesn't need attention. The scripts folder, however, contains useful scripts for quick operations:

• update.sh: A script that checks for system or package updates, used by the Waybar module.
• install_updates.sh: This script is triggered when you click the Waybar update module.
• set_font.sh: A script for setting the system-wide font. Use the -m flag for module-specific control. More details can be seen by running the script with the -h flag.
• screenshot.sh: Originally from the ML4W repository, this script is used to take screenshots via grim.
• set_gtk.sh: Reloads GTK themes at Hyprland startup.

Hyprland

The Hyprland configuration is crucial and divided into multiple files for easy management. All configurations are stored in ~/.config/hypr, and specific configurations are in ~/.config/hypr/configs. The filenames are descriptive, so I'll refrain from listing them here.

For a deeper understanding, I recommend checking the Official Hyprland Wiki.

Rofi

Rofi is the application launcher provided with the repo. You can modify its configuration in ~/.config/rofi/configuration.rasi.

For more details, visit the Official Rofi Documentation.

SDDM

In the ~/.config/sddm folder, you’ll find two files that are not directly linked to SDDM's behavior. Modifying these files won't affect SDDM unless they are moved to specific directories.

• theme.conf: Configuration file for the Sugar-Candy theme. To apply changes, copy it to /usr/share/sddm/themes/sugar-candy (requires sudo permissions).
• sddm.conf: SDDM configuration file. If you modify the theme, adjust the [Theme] value and copy it to /etc/sddm.d.

IMPORTANT NOTE: Modifying these files may break SDDM, resulting in a blank screen at logout. If you want to test changes before rebooting, run:

sddm-greeter --test-mode --theme /usr/share/sddm/themes/YOUR_THEME_FOLDER

If issues arise, address them before restarting.

This image is taken from the internet, as screenshots cannot be captured outside of a logged-in session.

Starship

Starship is the prompt used in the terminal. You can edit its configuration by modifying ~/.config/starship.toml.

Refer to the Official Starship Wiki for more details. The colors change according to pywal. If you want to disable this, edit ~/.config/bashrc/startup_commands.sh and comment out the line:

# Apply pywal colors to the terminal
cat ~/.cache/wal/sequences

To remove Starship, comment out the following lines:

eval "$(starship init bash)"

PyWal

PyWal changes the system's colors based on the wallpaper. Templates used by PyWal are stored in ~/.config/wal. The color schemes generated by PyWal are saved in ~/.cache/wal. To adjust the saturation, edit set_wallpaper.sh and add the --saturation flag:

# Run pywal to change the color scheme
wal -q -i $wallpaper

Once generated the new color schemes, you find them in ~/.cache/wal directory. Pywal automatically generates some color schemes and additionally uses the templates found in the ~/.config/wal/templates folder for generating also custom color schemes.

For more information, visit the Official PyWal Documentation.

Waybar

Waybar is shipped with two themes created by me. The themes are available in ~/.config/waybar/themes/.

You can either modify an existing theme or create a new one by creating a new folder in ~/.config/waybar/themes/MY_THEME. I suggest to start from the shipped theme and then create your own style from there as it will be simpler.

To select the theme you must change the paths in ~/.config/waybar/launch.sh that specifies the config and style sheet.

Wlogout

Wlogout provides a simple logout menu accessible via the power button on the Waybar. You can change its style by editing style.css.

Brave and Chromium

These two browser whenever installed and then set as default browsers using .config/dotfiles/scripts/applications.sh set browser YOUR_BROWSER will be launched using the flags specified in .config/YOUR_BROWSER-flags.conf.

IMPORTANT NOTE: Use this method to set the browser as defualt in this way also the waybar module will be updated changing the icon based on the selected browser. In this way the flags config file will be generated, the specified flags are used to ensure compatibility with wayland (avoiding glitches) and the two-fingers gestures.