### Example post.sh script for installing packages

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Protect-your-configuration-and-customize-the-installation

Use helper functions like _installPackagesPacman, _installPackagesYay, and _installPackagesFlatpak in post.sh to install additional software after the ML4W Dotfiles are set up. This script runs at the end of the installation.

```bash
#!/bin/bash
# ------------------------------------------------------
# Don't edit this section
# Include scripts.sh with helper functions
source library/scripts.sh
# ------------------------------------------------------

# Show Current version
echo ":: Running hook for ML4W Dotfiles $version"

# Install additional packages
_installPackagesPacman "kitty"
_installPackagesYay "wlogout"
_installPackagesFlatpak "com.spotify.Client"

# Remove installed packages
# sudo pacman -R alacritty

```

--------------------------------

### Install with AUR on Arch Linux

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Installation-2.9.7

Alternative installation method for Arch Linux using the AUR. After installation, run the setup script and note that the AUR may show an older version during the process.

```bash
yay -S ml4w-hyprland-git
```

--------------------------------

### Start ML4W Hyprland App from Terminal

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/ML4W-Hyprland-Settings-App

Launch the ML4W Hyprland Settings application directly from your terminal. No additional setup is required if the application is installed in your system's PATH.

```bash
ml4w-hyprland
```

--------------------------------

### Manual Git Installation of ML4W OS (Rolling Release)

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Manually installs the rolling release version of ML4W OS by cloning the repository and running the setup script. Suitable for users who prefer manual control.

```bash
cd ~/Downloads
git clone --depth=1 https://github.com/mylinuxforwork/dotfiles.git

cd dotfiles/bin
./ml4w-hyprland-setup
```

--------------------------------

### Launch Hyprland from TTY

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Launch-Hyprland

To start Hyprland directly from the command line, execute the 'Hyprland' command. Ensure Hyprland is installed and configured in your system's PATH.

```bash
# Start Hyprland
Hyprland
```

--------------------------------

### Custom Hyprland Configuration Example

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Example of a custom.conf file for Hyprland, allowing personal configurations that persist through updates. Includes examples for autostart commands, environment variables, keybindings, and window rules.

```bash
# ~/.config/hypr/conf/custom.conf

# Custom autostart commands
exec-once = discord
exec-once = spotify

# Custom environment variables
env = CUSTOM_VAR,value

# Custom keybindings
bind = $mainMod, D, exec, discord

# Custom window rules
windowrule {
    name = custom-app
    match:class = (my-app)
    float = true
    center = true
    size = 800 600
}
```

--------------------------------

### Install ML4W Dotfiles Rolling Release via Git

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Installation

Clone the latest version of the dotfiles repository and run the setup script manually. This method installs the rolling release. Note that not all features may work with this installation method.

```bash
# 1.) Change into your Downloads folder (create the folder if not available)
cd ~/Downloads

# 2.) Clone the dotfiles repository into the Downloads folder
git clone --depth=1 https://github.com/mylinuxforwork/dotfiles.git

# 3.) Change into the dotfiles/bin folder
cd dotfiles/bin

# 4.) Start the installation
./ml4w-hyprland-setup
```

--------------------------------

### Install SDDM and ML4W Theme

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Installs SDDM and the ML4W theme. This can be done through the Welcome App or by running the script directly.

```bash
~/.config/ml4w/scripts/ml4w-install-sddm
```

--------------------------------

### Install nwg-dock-hyprland with yay

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Add-a-dock-with-nwg‐dock‐hyprland

Use this command to install the nwg-dock-hyprland package using the yay AUR helper. Ensure yay is installed and configured.

```bash
yay -S nwg-dock-hyprland
```

--------------------------------

### ML4W Dotfiles Installer

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

A new installation script based on the ML4W Dotfiles Installer.

```text
ML4W Dotfiles Installer
```

--------------------------------

### Start Quicklinks Script

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Terminal command to start the quicklinks script.

```bash
quick
```

--------------------------------

### Prepare automation.sh script

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Automation-of-the-installation-and-update

Copy the template file and make it executable to enable automated installation and updates.

```bash
cp automation.tpl automation.sh
chmod +x automation.sh
```

--------------------------------

### Install ML4W Dotfiles Main Release (Arch Linux)

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Installation

Install the latest tagged release of ML4W Dotfiles on Arch Linux using the AUR helper 'yay'. This command installs the package and then runs the setup script.

```bash
yay -S ml4w-hyprland
ml4w-hyprland-setup
```

--------------------------------

### Install Brave Browser

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Change-the-default-browser

Use this command to install the Brave browser via yay. Ensure you have yay or another AUR helper installed.

```bash
yay -S brave-bin
```

--------------------------------

### Start Wallpaper Selector CLI

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Terminal command to start the wallpaper selector command-line interface.

```bash
wallpaper
```

--------------------------------

### Update ML4W Dotfiles from Older Versions (pre-2.9.6) with AUR

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Update

For versions older than 2.9.6, install the latest version as an AUR package and then start the setup. This method is recommended for seamless updates.

```bash
# Download the latest version (main release)
yay -S ml4w-hyprland

# Start the setup
ml4w-hyprland-setup
```

--------------------------------

### Update ML4W Dotfiles with AUR Helper

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Update

Use your AUR helper to update system packages and then run the ML4W setup script. Ensure the installation folder name does not contain spaces.

```bash
yay
```

```bash
ml4w-hyprland-setup
```

--------------------------------

### Hyprland Decoration Configuration Example

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Example configuration for Hyprland window decorations, including rounding, opacity, blur effects, and shadow settings. This configuration is typically found in ~/.config/hypr/conf/decorations/default.conf.

```bash
decoration {
    rounding = 10
    active_opacity = 1.0
    inactive_opacity = 0.9
    fullscreen_opacity = 1.0

    blur {
        enabled = true
        size = 4
        passes = 4
        new_optimizations = on
        ignore_opacity = true
        xray = true
    }

    shadow {
        enabled = true
        range = 32
        render_power = 2
        color = rgba(00000050)
    }
}
```

--------------------------------

### Launch ML4W Welcome App from Terminal

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/ML4W-Welcome-App

Start the ML4W Welcome App by typing 'ml4w' in your terminal. This command assumes the .bashrc from the dotfiles is in use.

```bash
ml4w
```

--------------------------------

### Manually Install Rofi-Wayland or Rofi

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Troubleshooting

If rofi-wayland fails to install during an update, try installing it manually using yay. If it's unavailable, attempt to install the standard 'rofi' package instead.

```bash
yay -S rofi-wayland
```

```bash
yay -S rofi
```

--------------------------------

### Install nwg-displays on Fedora

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Monitor-Configuration

Use this command to install the nwg-displays application on Fedora systems.

```bash
sudo dnf install nwg-displays
```

--------------------------------

### Install Waypaper

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Waypaper needs to be installed separately if you wish to use it.

```text
installed separately
```

--------------------------------

### Install ML4W Dotfiles Rolling Release (Arch Linux)

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Installation

Install the main branch (rolling release) of ML4W Dotfiles on Arch Linux using the AUR helper 'yay'. This command installs the git version of the package and then runs the setup script.

```bash
yay -S ml4w-hyprland-git
ml4w-hyprland-setup
```

--------------------------------

### Reinstall hypridle and hyprlock

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Troubleshooting

If hypridle and hyprlock fail to start after a dotfiles update, ensure they are installed correctly. If file conflicts occur, remove the debug files manually before reinstalling.

```bash
yay -S hypridle hyprlock
```

```bash
sudo rm /usr/lib/debug/usr/bin/hypridle.debug
```

```bash
sudo rm /usr/lib/debug/usr/bin/hyprlock.debug
```

```bash
yay -S hypridle hyprlock
```

--------------------------------

### Install ML4W nvim Configuration

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Use this script to install the ML4W Neovim configuration. It can be accessed via the Welcome App or run directly.

```bash
~/.config/ml4w/scripts/ml4w-install-nvim
```

--------------------------------

### Install nwg-displays on Arch Linux

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Monitor-Configuration

Use this command to install the nwg-displays application on Arch Linux systems.

```bash
sudo pacman -S nwg-displays
```

--------------------------------

### Configure Theme Script Structure

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Example structure for a custom theme script. Sets Waybar, dock, SwayNC, launcher, and window decoration styles by writing to specific configuration files and reloading services.

```bash
#!/usr/bin/env bash
# Example: ~/.config/ml4w/themes/glass/theme.sh

# Set waybar theme
echo "/ml4w-glass-center;/ml4w-glass-center/default" > $HOME/.config/ml4w/settings/waybar-theme.sh
$HOME/.config/waybar/launch.sh &

# Set dock theme
echo "glass" > $HOME/.config/ml4w/settings/dock-theme
$HOME/.config/nwg-dock-hyprland/launch.sh &

# Set SwayNC theme
echo '@import "themes/glass/style.css";' > $HOME/.config/swaync/style.css
swaync-client -rs

# Set launcher
echo 'rofi' > $HOME/.config/ml4w/settings/launcher

# Set window decoration
echo 'source = ~/.config/hypr/conf/windows/default.conf' > $HOME/.config/hypr/conf/window.conf

# Set rofi border
echo '* { border-width: 1px; }' > $HOME/.config/ml4w/settings/rofi-border.rasi
```

--------------------------------

### Install ML4W Dotfiles on Fedora Linux

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Installation

Execute this command to install the ML4W Dotfiles on Fedora-based systems. The script will prompt for an installation folder name.

```bash
bash <(curl -s https://raw.githubusercontent.com/mylinuxforwork/dotfiles/main/setup-fedora.sh)
```

--------------------------------

### Install downgrade package

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Installation-in-a-KVM-virtual-machine

Use this command to install the 'downgrade' package manager helper, which allows you to install older versions of packages.

```bash
yay -S downgrade
```

--------------------------------

### Install Yazi

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Yazi needs to be installed separately to be used as the file manager.

```text
to be installed separately
```

--------------------------------

### Install xdg-desktop-portal-gtk Package

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Troubleshooting

Install this package to enable dark theme support in GTK4 applications. It can be installed via the Post Installation Script or directly with pacman.

```bash
sudo pacman -S xdg-desktop-portal-gtk
```

--------------------------------

### Install ML4W Hyprland Dotfiles

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Installation-in-a-KVM-virtual-machine

After downgrading necessary packages, use this command to install the ML4W Hyprland Dotfiles.

```bash
yay -S ml4w-hyprland
```

--------------------------------

### Clone and Install ML4W Dotfiles

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Using-ML4W-Dotfiles-on-other-distributions

Follow these steps to clone the dotfiles repository and copy them to your home directory. Ensure you are in the Downloads folder before cloning.

```bash
# 1.) Change into your Downloads folder (create the folder if not available)
cd ~/Downloads

# 2.) Clone the dotfiles repository into the Downloads folder
git clone --depth=1 https://github.com/mylinuxforwork/dotfiles.git

# 3.) Change your keyboard layout
cd dotfiles/share/dotfiles/.config/hypr/conf/
vim keyboard.conf

# 4.) Change into the dotfiles folder
cd dotfiles/share/dotfiles/.config

# 5.) Copy the dotfiles to your home directory
cp -r . ~/.config

```

--------------------------------

### Install Nvidia Driver with ML4W

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Hyprland-and-NVIDIA

Use this command to install the NVIDIA proprietary driver when using ML4W Dotfiles. A grub bootloader is required.

```bash
ml4w-hyprland-setup -m nvidia
```

--------------------------------

### Hyprland Animation Configuration Example

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Example configuration for Hyprland window animations, defining bezier curves and animation properties for various window actions. This configuration is typically found in ~/.config/hypr/conf/animations/default.conf.

```bash
animations {
    enabled = true

    # Animation curves
    bezier = md3_standard, 0.2, 0, 0, 1
    bezier = md3_decel, 0.05, 0.7, 0.1, 1
    bezier = md3_accel, 0.3, 0, 0.8, 0.15
    bezier = overshot, 0.05, 0.9, 0.1, 1.1
    bezier = menu_decel, 0.1, 1, 0, 1
    bezier = menu_accel, 0.38, 0.04, 1, 0.07

    # Animation configs
    animation = windows, 1, 3, md3_decel, popin 60%
    animation = windowsIn, 1, 3, md3_decel, popin 60%
    animation = windowsOut, 1, 3, md3_accel, popin 60%
    animation = border, 1, 10, default
    animation = fade, 1, 3, md3_decel
    animation = layersIn, 1, 3, menu_decel, slide
    animation = layersOut, 1, 1.6, menu_accel
    animation = workspaces, 1, 7, menu_decel, slide
    animation = specialWorkspace, 1, 3, md3_decel, slidevert
}
```

--------------------------------

### ML4W Hyprland Settings App Installation

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

The ML4W Hyprland Settings app can be installed optionally from the Welcome app or via the provided URL.

```text
https://github.com/mylinuxforwork/hyprland-settings
```

--------------------------------

### Install ML4W OS - Stable Release

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/README.md

Use this command to install the stable release of ML4W OS. Ensure you have a compatible Arch Linux based distribution.

```bash
bash <(curl -s https://ml4w.com/os/stable) # Stable Release
```

--------------------------------

### Activate ML4W Dotfiles Installation

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Activate-another-ML4W-Dotfiles-installation

Execute this command to activate a specific ML4W Dotfiles installation. Ensure the ML4W Dotfiles version is 2.9.5 or higher.

```bash
~/.ml4w-hyprland/activate.sh
```

--------------------------------

### Install ML4W OS Stable on Arch Linux

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Installs the stable release of ML4W OS on Arch Linux using a one-liner script. Handles all dependencies and configuration.

```bash
bash <(curl -s https://ml4w.com/os/stable)
```

--------------------------------

### Install ML4W OS - Rolling Release

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/README.md

Use this command to install the rolling release of ML4W OS. This is suitable for users who prefer the latest updates.

```bash
bash <(curl -s https://ml4w.com/os/rolling) # Rolling Release
```

--------------------------------

### Install ML4W Dotfiles on Arch Linux

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Installation

Execute this command to install the ML4W Dotfiles on Arch Linux-based systems. Ensure you have backed up your existing .config folder.

```bash
bash <(curl -s https://raw.githubusercontent.com/mylinuxforwork/dotfiles/main/setup-arch.sh)
```

--------------------------------

### Launch ML4W Sidebar from Terminal

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/ML4W-Sidebar

Use this command to start the ML4W Sidebar application directly from your terminal.

```bash
ml4w-sidebar
```

--------------------------------

### Install ML4W OS via AUR on Arch Linux

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Installs ML4W OS on Arch Linux using the AUR helper 'yay'. Provides options for both the main stable release and the rolling release.

```bash
yay -S ml4w-hyprland
ml4w-hyprland-setup
```

```bash
yay -S ml4w-hyprland-git
ml4w-hyprland-setup
```

--------------------------------

### Install ML4W OS Rolling Release on Arch Linux

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Installs the rolling release version of ML4W OS on Arch Linux using a one-liner script. Includes the latest commits.

```bash
bash <(curl -s https://ml4w.com/os/rolling)
```

--------------------------------

### Automation Script Parameters

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Automation-of-the-installation-and-update

Configure various aspects of the dotfiles installation and update process by setting these boolean or string parameters in the automation.sh script. These control system updates, package installations, backups, and more.

```bash
#!/bin/bash
# Find the latest automation parameters here:
# https://github.com/mylinuxforwork/dotfiles/wiki/Automation-of-the-installation-and-update

# -----------------------------------------------------
# SYSTEM UPDATES
# true: Execute full system update with yay
# false: Skip system update with yay
# -----------------------------------------------------
automation_checkforupdates=false

# -----------------------------------------------------
# PARALLEL DOWNLOADS
# true: Will activate parallel downloads
# false: Skip the activation of parallel downloads
# -----------------------------------------------------
automation_paralleldownloads=true

# -----------------------------------------------------
# DOTFILES INSTALLATION FOLDER
# Define a folder including subfolder for the dotfiles
# E.g., dotfiles for installing in ~/dotfiles
# -----------------------------------------------------
automation_dotfilesfolder="dotfiles"

# -----------------------------------------------------
# OPTIONAL PACKAGES
# true: Offer the installation of optional packages
# false: Skip the installation of optional packages
# -----------------------------------------------------
automation_optional=false

# -----------------------------------------------------
# BACKUP OF YOUR DOTFILES
# true: Create a backup and archive it
# false: Skip the backup
# -----------------------------------------------------
automation_backup=true

# -----------------------------------------------------
# INSTALLTION
# true: Start the installation of new packages
# -----------------------------------------------------
automation_installation=true

# -----------------------------------------------------
# VM SUPPORT
# true: VM Support will be installed
# -----------------------------------------------------
automation_vm=false

# -----------------------------------------------------
# DISPLAY MANAGER
# true: Keep current setup
# -----------------------------------------------------
automation_displaymanager=true

# -----------------------------------------------------
# RESTORE
# true: Try to restore existing settings and configurations
# -----------------------------------------------------
automation_restore=true

# -----------------------------------------------------
# KEYBOARD
# true: Proceed with existing keyboard configuration
# -----------------------------------------------------
automation_keyboard=true

# -----------------------------------------------------
# EXECUTE HOOK SCRIPT
# true: Execute the hook.sh if exists
# -----------------------------------------------------
automation_hook=false

# -----------------------------------------------------
# BASH RC
# true: Install the ML4W .bashrc
# false: Keep existing .bashrc
# -----------------------------------------------------
automation_bashrc=true

# -----------------------------------------------------
# ZSH RC
# true: Install the ML4W .zshrc
# false: Keep existing .zshrc
# -----------------------------------------------------
automation_zshrc=true

# -----------------------------------------------------
# NEOVIM
# true: Install neovim configuration
# false: Skip installation of neovim configuration
# -----------------------------------------------------
automation_neovim=true

# -----------------------------------------------------
# COPY TO TARGETFOLDER
# true: Prepared dotfiles will be copied to the target folder
# -----------------------------------------------------
automation_copy=true

# -----------------------------------------------------
# RUN DIAGNOSIS
# true: Will execute the diagnosis script
# -----------------------------------------------------
automation_diagnosis=true

# -----------------------------------------------------
# EXECUTE POST SCRIPT
# true: Execute the post.sh if exists
# -----------------------------------------------------
automation_post=false
```

--------------------------------

### Add nwg-dock-hyprland launch command to Hyprland config

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Add-a-dock-with-nwg‐dock‐hyprland

Add this line to your Hyprland custom configuration file to automatically launch the dock script on login. This ensures the dock is available when Hyprland starts.

```bash
exec-once = ~/.config/nwg-dock-hyprland/launch.sh
```

--------------------------------

### Example hook.sh script for protecting dotfiles

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Protect-your-configuration-and-customize-the-installation

Use the _protect function in hook.sh to prevent specific configuration files or folders from being overwritten during ML4W Dotfiles updates. This script runs before files are copied.

```bash
#!/bin/bash
# ------------------------------------------------------
# Don't edit this section
# Include scripts.sh with helper functions
source library/scripts.sh
# ------------------------------------------------------

# Show Current version
echo ":: Running hook for ML4W Dotfiles $version"

# If you made adjustments in the installation folder e.g., ~/dotfiles folder 
# you can protect the files and folders from being overwritten by updates.

_protect .config/nvim
_protect .bashrc

# You can add more command to get executed before the prepared dotfiles 
# will be copied to the target folder ~/dotfiles

```

--------------------------------

### Configure Autostart Services

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Define scripts and applications to be executed once on startup for listeners, authentication agents, and desktop components.

```hyprland
# ~/.config/hypr/conf/autostart.conf

# Start listener scripts (theme switching, battery notifications)
exec-once = ~/.config/ml4w/listeners.sh --startall

# Start Polkit authentication agent
exec-once = /usr/lib/polkit-gnome/polkit-gnome-authentication-agent-1

# Restore last wallpaper
exec-once = ~/.config/ml4w/scripts/ml4w-wallpaper-app --restore

# Main autostart (Quickshell widgets, settings app)
exec-once = ~/.config/ml4w/scripts/ml4w-autostart

# Load GTK settings
exec-once = ~/.config/hypr/scripts/gtk.sh

# Notification daemon
exec-once = swaync

# Screen locker
exec-once = hypridle

# Clipboard history
exec-once = wl-paste --watch cliphist store

# Cleanup script
exec-once = ~/.config/hypr/scripts/cleanup.sh

# Load ML4W Hyprland Settings App configuration
exec = ~/.config/com.ml4w.hyprlandsettings/hyprctl.sh
```

--------------------------------

### Copr for Hyprland on Fedora

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

The copr for Hyprland on Fedora has been replaced. Re-run the setup script with the Dotfiles Installer.

```text
Dotfiles Installer
```

--------------------------------

### Initialize swww with format for gray background fix

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

This command is used to initialize swww, ensuring a gray background fix. It's recommended to use this in autostart configurations.

```shell
exec-once = swww init || swww-daemon --format xrgb
```

--------------------------------

### Configure Appearance Settings

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Set appearance-related configurations such as blur strength, wallpaper directory, and Rofi styles.

```bash
# Blur strength (format: SIZExSTRENGTH)
echo "50x30" > ~/.config/ml4w/settings/blur.sh
```

```bash
# Wallpaper folder
echo '$HOME/.config/ml4w/wallpapers' > ~/.config/ml4w/settings/wallpaper-folder
```

```bash
# Wallpaper effect (off, blur, etc.)
echo "off" > ~/.config/ml4w/settings/wallpaper-effect
```

```bash
# Wallpaper transition effect
echo "wipe" > ~/.config/ml4w/settings/wallpaper-transition-effect
```

```bash
# Rofi font
echo 'font: "Fira Sans 12";' > ~/.config/ml4w/settings/rofi-font.rasi
```

```bash
# Rofi border
echo '* { border-width: 2px; }' > ~/.config/ml4w/settings/rofi-border.rasi
```

--------------------------------

### Select Global Theme with ML4W

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Applies a unified theme across Waybar, dock, SwayNC, and launcher. Use the script to open the theme selector or configure themes manually.

```bash
~/.config/ml4w/themes/themes.sh
```

--------------------------------

### Configure Toolkit Backends for Wayland/X11

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Switch-SDL-Videodriver-between-Wayland-and-x11

Configure multiple toolkit backends, prioritizing Wayland, then X11. Ensure the SDL_VIDEODRIVER is set to wayland. This configuration should be moved to your custom.conf.

```shell
env = GDK_BACKEND,wayland,x11,*
env = SDL_VIDEODRIVER,wayland
env = CLUTTER_BACKEND,wayland
```

--------------------------------

### Open Theme Selector

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Keybinding to open the global theme selector.

```bash
CTRL+ALT+T
```

--------------------------------

### Toggle Quickshell Overview

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Keybinding to toggle the Quickshell Overview.

```bash
CTRL+TAB
```

--------------------------------

### Dock Auto-hide (BETA)

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Activate dock auto-hide by creating this file. This feature is in Beta.

```bash
.config/ml4w/settings/dock-autohide
```

--------------------------------

### Create System Snapshot with Timeshift

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Execute the ml4w-snapshot script to create a Timeshift system snapshot with grub-btrfs integration. This script prompts for a comment, creates the snapshot, and updates GRUB. It is compatible with Arch, Fedora, and openSUSE.

```bash
~/.config/ml4w/scripts/ml4w-snapshot
```

--------------------------------

### Oh-my-posh Custom Theme Initialization for Zsh

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Customize-zsh-and-bash

Initializes the oh-my-posh prompt with a custom theme located at ~/.config/ohmyposh/zen.toml. Ensure the theme file exists.

```zsh
# -----------------------------------------------------
# oh-my-posh promt
# -----------------------------------------------------
# Custom Theme
eval "$(oh-my-posh init zsh --config $HOME/.config/ohmyposh/zen.toml)"
```

--------------------------------

### Install CJK Fonts for Proper Character Rendering

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Troubleshooting

Install the noto-fonts-cjk package to ensure correct display of Chinese, Japanese, and Korean characters in applications on Arch Linux.

```bash
sudo pacman -S noto-fonts-cjk
```

--------------------------------

### Oh-my-zsh Plugins Configuration

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Customize-zsh-and-bash

List of plugins installed with oh-my-zsh. These can be managed by modifying this list.

```zsh
plugins=(
    git
    sudo
    web-search
    archlinux
    zsh-autosuggestions
    zsh-syntax-highlighting
    fast-syntax-highlighting
    copyfile
    copybuffer
    dirhistory
)
```

--------------------------------

### Waypaper Optional Selection

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Waypaper can be optionally selected in the Settings App or Default Apps, but requires separate installation.

```text
Settings App and Default Apps
```

--------------------------------

### Launch Yazi File Manager

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Terminal command to launch the yazi file manager. Requires separate installation.

```bash
filemanager
```

--------------------------------

### Uninstall ML4W Dotfiles Package (Standard)

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Uninstall

Remove the ML4W Dotfiles package using the `yay` AUR helper. This is for standard installations.

```bash
yay -R ml4w-hyprland
```

--------------------------------

### Rename and make post.sh executable

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Protect-your-configuration-and-customize-the-installation

Rename the template file post.tpl to post.sh and make it executable to define actions to be performed after the main installation.

```bash
mv post.tpl post.sh
chmod +x post.sh
```

--------------------------------

### Configure Waybar Theme

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Sets the Waybar theme by writing the theme path to a settings file. The format is /THEME;/THEME/VARIATION.

```bash
echo "/ml4w-glass-center;/ml4w-glass-center/default" > ~/.config/ml4w/settings/waybar-theme.sh
```

--------------------------------

### SDDM Wallpaper Script

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

This script copies the current wallpaper to SDDM to use as a background image. It can be started via script or the Welcome App.

```text
~/.config/ml4w/scripts/ml4w-install-sddm or from the Welcome App/Settings/Display Manager
```

--------------------------------

### New Quickshell Wallpaper Selector

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Toggle the new Quickshell based wallpaper selector with this keybinding.

```bash
SUPER+CTRL+W
```

--------------------------------

### Resolve Waybar Icon Conflicts

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Home/Troubleshooting

If Waybar icons are missing, it might be due to font conflicts. Uninstall 'ttf-ms-fonts' and install 'ttf-font-awesome' and 'otf-font-awesome' using yay.

```bash
yay -R ttf-ms-fonts
```

```bash
yay -S ttf-font-awesome otf-font-awesome
```

--------------------------------

### Activate Hyprland Configuration Variation

Source: https://context7.com/mylinuxforwork/dotfiles/llms.txt

Activate a Hyprland configuration variation by overwriting the relevant configuration file. For example, to change animation settings, edit ~/.config/hypr/conf/animation.conf.

```bash
echo 'source = ~/.config/hypr/conf/animations/smooth.conf' > ~/.config/hypr/conf/animation.conf
```

--------------------------------

### Launch Launcher Script

Source: https://github.com/mylinuxforwork/dotfiles/blob/main/CHANGELOG.md

Terminal command to launch the application launcher script.

```bash
apps
```

--------------------------------

### Configure Screenshot Editor

Source: https://github.com/mylinuxforwork/dotfiles/wiki/Making-Screenshots

You can set a custom screenshot editor by entering its command in the ML4W Settings App. For example, use `swappy -f` for Swappy or `gimp` for GIMP.

```shell
spappy -f
```

```shell
gimp
```