Updates

.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

README.md

@@ -170,40 +170,6 @@ To fix the mouse issue on Hyprland, open the Hyprland settings with <kbd>SUPER</
 
 If you want to install only the core packages of Hyprland as a starting point for your Hyprland experiments please also try my Hyprland Starter script: https://gitlab.com/stephan-raabe/hyprland-starter
 
-# 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 <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>F3</kbd> 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
 
 - <kbd>SUPER</kbd> + <kbd>RETURN</kbd>: Alacritty
@@ -229,6 +195,32 @@ All keybindings for Qtile: https://gitlab.com/stephan-raabe/dotfiles/-/blob/main
 
 <a href="https://youtu.be/e9ro_P9rbFk" target="_blank">Watch on YouTube</a>
 
+## 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.
+
+<img src="screenshots/screenshot-welcome.app.png" />
+
+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 <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>W</kbd> 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 <kbd>CTRL</kbd> + <kbd>ALT</kbd> + <kbd>F3</kbd> 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

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
 # -----------------------------------------------------