diff --git a/.bashrc b/.bashrc
index 0489ef5..1e47a5d 100644
--- a/.bashrc
+++ b/.bashrc
@@ -36,6 +36,7 @@ alias rw='~/dotfiles/waybar/reload.sh'
alias winclass="xprop | grep 'CLASS'"
alias dot="cd ~/dotfiles"
alias cleanup='~/dotfiles/scripts/cleanup.sh'
+alias ml4w='~/dotfiles/apps/ML4W_Welcome-x86_64.AppImage'
# -----------------------------------------------------
# Window Managers
diff --git a/README.md b/README.md
index 0871912..19dadc0 100644
--- a/README.md
+++ b/README.md
@@ -170,40 +170,6 @@ To fix the mouse issue on Hyprland, open the Hyprland settings with SUPERCTRL + ALT + F3 Now you can login with your user.
-
-Start Hyprland with Hyprland.
-
-You can try to reinstall all sddm related packages.
-
-```
-yay -S sddm-git sddm-sugar-candy-git
-```
-
-Or you can install another display manager.
-
-To stop, disable and remove sddm service.
-
-```
-sudo systemctl stop sddm.service
-sudo systemctl disable sddm.service
-sudo rm /etc/systemd/system/display-manager.service
-```
-
-
# Some important key bindings
- SUPER + RETURN: Alacritty
@@ -229,6 +195,32 @@ All keybindings for Qtile: https://gitlab.com/stephan-raabe/dotfiles/-/blob/main
Watch on YouTube
+## ML4W Welcome App
+
+After starting the ML4W dotfiles for the first time, the ML4W Welcome App appears. This app is the starting point to discover the Hyprland setup.
+
+
+
+The welcome screen includes the most important keybindings to open a terminal or a browser.
+
+You can start the ML4W Welcome App by clicking on the L icon on the right side in waybar or be entering ml4w in your terminal (if you're using the .bashrc from the dotfiles).
+
+In the Settings Menu you can access the following functions:
+
+- Update Wallpaper: Opens the wallpaper selector
+- Change Waybar Theme: Opens the waybar theme switcher and gives access to the available themes for the waybar status bar
+- Change GTK Theme: Opens nwg-look to select the theme for GTK 3 applications incl. widgets, icons and cursors
+- Refresh GTK Settings: Reloads the Hyprland GTK configuration (required when changing the mouse cursor)
+- Hyprland Settings: Opens the Hyprland Settings script to customize the look and feel, environment variables, monitor resolution, etc.
+- Network Settings: Select your network configuration incl. WiFi
+- Update your System: Starts the terminal application to update your Arch packages (pacman & yay)
+- Cleanup your System: Removes old orphans and cached files generated during previous installations
+- Reload Waybar: Reloads the waybar
+- Toggle Waybar: You can hide or show waybar when you want to try our other status bars.
+
+You can find the sourcecode of the ML4W Welcome App in this repository:
+https://gitlab.com/stephan-raabe/ml4w-welcome
+
## Wallpaper and Pywal
Included is a pywal configuration that changes the color scheme based on a randomly selected wallpaper. With the key binding SUPER + SHIFT + W you can change the wallpaper coming from the folder ~/wallpaper/.
@@ -310,6 +302,39 @@ Included is a pywal configuration that changes the color scheme based on a rando
- Compositor: picom
- Screenshots: scrot
+# Troubleshooting
+
+## Missing icons in waybar
+
+In case of missing icons on waybar, it's due to a conflict between several installed fonts (can happen especially on Arco Linux). Please make sure that ttf-ms-fonts is uninstalled and ttf-font-awesome and otf-font-awesome are installed with
+
+```
+yay -R ttf-ms-fonts
+yay -S ttf-font-awesome otf-font-awesome
+```
+
+## SDDM not showing (only black screen with cursor)
+
+Switch to another tty with CTRL + ALT + F3 Now you can login with your user.
+
+Start Hyprland with Hyprland.
+
+You can try to reinstall all sddm related packages.
+
+```
+yay -S sddm-git sddm-sugar-candy-git
+```
+
+Or you can install another display manager.
+
+To stop, disable and remove sddm service.
+
+```
+sudo systemctl stop sddm.service
+sudo systemctl disable sddm.service
+sudo rm /etc/systemd/system/display-manager.service
+```
+
# Wallpaper repository
You can find my wallpaper collection in the repository https://gitlab.com/stephan-raabe/wallpaper
diff --git a/apps/ML4W_Welcome-x86_64.AppImage b/apps/ML4W_Welcome-x86_64.AppImage
index fed6f31..5425fe1 100755
Binary files a/apps/ML4W_Welcome-x86_64.AppImage and b/apps/ML4W_Welcome-x86_64.AppImage differ
diff --git a/screenshots/screenshot-welcome.app.png b/screenshots/screenshot-welcome.app.png
new file mode 100644
index 0000000..8cacb50
Binary files /dev/null and b/screenshots/screenshot-welcome.app.png differ
diff --git a/waybar/launch.sh b/waybar/launch.sh
index 423e1bc..2cf44ae 100755
--- a/waybar/launch.sh
+++ b/waybar/launch.sh
@@ -8,6 +8,13 @@
# by Stephan Raabe (2023)
# -----------------------------------------------------
+# Check if waybar-disabled file exists
+if [ -f $HOME/.cache/waybar-disabled ] ;then
+ killall waybar
+ pkill waybar
+ exit 1
+fi
+
# -----------------------------------------------------
# Quit all running waybar instances
# -----------------------------------------------------