Hyprland-dotfiles/README.md

528 lines
20 KiB
Markdown
Raw Normal View History

2024-05-22 11:06:47 -04:00
# ML4W Dotfiles 2.9.1 BETA3
2023-01-22 12:27:01 -05:00
2024-03-01 15:23:40 -05:00
An advanced configuration of Hyprland and Qtile for Arch Linux based distributions. This package includes an installation script to install and setup the required components.
2023-10-18 11:39:51 -04:00
2024-05-02 10:17:38 -04:00
[![Screenshot](screenshots/v29/screenshot-29-1.png "Screenshot")](screenshots/v29/screenshot-29-1.png)
2024-03-18 13:24:08 -04:00
2024-03-15 03:44:26 -04:00
The ML4W Dotfiles are available as
2024-03-20 06:34:07 -04:00
- main release (Official release): [https://gitlab.com/stephan-raabe/dotfiles](https://gitlab.com/stephan-raabe/dotfiles)
- rolling release (Development release): [https://gitlab.com/stephan-raabe/dotfiles/-/tree/dev](https://gitlab.com/stephan-raabe/dotfiles/-/tree/dev)
2024-03-15 03:44:26 -04:00
2024-05-04 06:36:11 -04:00
YouTube Video [https://youtu.be/HMxHUvN6VGo](https://youtu.be/HMxHUvN6VGo)
2023-11-26 10:00:12 -05:00
[TOC]
2023-11-26 10:06:51 -05:00
# Installation
2023-04-06 08:49:57 -04:00
2024-04-01 07:37:11 -04:00
The package includes an installation script that will guide you through all steps of the installation or update process.
2023-12-24 08:12:10 -05:00
2024-04-01 07:37:11 -04:00
> PLEASE NOTE: Every Linux distribution and setup can be different. Therefore, I cannot guarantee that the installation will work everywhere. Installation on your own risk.
2024-03-01 02:55:45 -05:00
2023-12-25 09:17:40 -05:00
## Supported platforms
The dotfiles are tested with the following Arch based distributions:
- Arch Linux (recommended)
2024-03-01 15:23:40 -05:00
- EndeavourOS
2024-05-23 08:00:01 -04:00
- Manjaro Linux
2024-05-04 06:36:11 -04:00
- Garuda Linux
2023-12-25 09:17:40 -05:00
- Arco Linux
2024-03-01 15:23:40 -05:00
The installation should work on all Arch Linux based distributions as well.
2023-12-25 09:12:46 -05:00
2024-05-04 06:36:11 -04:00
> **For Manjaro users:** Hyprland and required packages are under ongoing development. That's why it could be possible that some packages are not immediatly available on Manjaro. But usually, the packages will be published later. Maybe you can install required packages manually.
2024-03-02 15:01:39 -05:00
2024-03-20 06:47:10 -04:00
> **For Arco Linux users:** Please reinstall/force the installation of all packages during the installation/update process of the install script. The script will also offer to remove ttf-ms-fonts if installed to avoid issues with icons on waybar.
2023-11-24 09:30:48 -05:00
2023-12-25 09:17:40 -05:00
## Before you start
2024-03-20 06:47:10 -04:00
**PLEASE BACKUP YOUR EXISTING .config FOLDER WITH YOUR DOTFILES BEFORE STARTING THE SCRIPTS FOR INITIAL INSTALLTION.**
2023-08-31 09:01:03 -04:00
2024-04-01 07:37:11 -04:00
The installation script will create a backups from configurations of your .config folder that will be overwritten from the installation procedure and previous ML4W Dotfiles installation.
2023-12-19 07:00:57 -05:00
2024-03-18 11:37:48 -04:00
If possible, please create a snapshot of your current system if snapper or Timeshift is installed and available.
2024-03-28 11:10:36 -04:00
## Installation
2024-01-07 09:45:51 -05:00
2024-05-23 08:08:47 -04:00
The easiest way is to use the setup.sh script. The script will download all files from GitLab and start the installation.
2024-04-01 07:37:11 -04:00
2024-05-23 08:08:47 -04:00
Just copy/enter the following command into your terminal.
2024-04-01 07:37:11 -04:00
```
2024-05-23 08:08:47 -04:00
bash <(curl -s "https://gitlab.com/stephan-raabe/dotfiles/-/raw/dev/setup.sh")
2024-03-19 11:58:35 -04:00
```
2024-01-07 09:45:51 -05:00
2024-05-23 08:08:47 -04:00
Alternatively you can install with GIT (see below).
2023-11-24 03:35:31 -05:00
2024-02-29 11:43:33 -05:00
## Update
2023-11-26 07:34:37 -05:00
2024-03-28 11:10:36 -04:00
You can use the integrated update feature to update your dotfiles to the main or rolling release whenever you want.
2024-03-07 09:51:34 -05:00
2024-03-20 06:47:10 -04:00
![Update](screenshots/welcome-update-dotfiles.png "Updates")
2024-03-07 09:51:34 -05:00
2024-03-28 11:10:36 -04:00
Start the ML4W Welcome App. You will see a notification when an update is available. You can start the update or re-installation of the ML4W Dotfiles at any time.
2024-03-07 09:51:34 -05:00
You can force a clean re-installation of the dotfiles by removing the folder ~/dotfiles before starting the installation.
2024-03-20 06:47:10 -04:00
> Please note that you can create a backup of your existing configuration with the backup feature of the install script. It's recommended to remove the folder ~/dotfiles only after creating a backup.
2024-03-07 09:51:34 -05:00
2024-04-01 07:37:11 -04:00
## Uninstall
2023-12-07 15:32:32 -05:00
2024-04-01 07:37:11 -04:00
You can use the integrated uninstallation function (ML4W Dotfiles Uninstaller App) to remove the ML4W Dotfiles from your system.
2023-12-07 15:32:32 -05:00
2024-04-01 07:37:11 -04:00
Please select "Uninstall Dotfiles" from the ML4W Welcome App or execute ~/dotfiles/uninstall.sh
2023-12-07 15:32:32 -05:00
2024-04-01 07:37:11 -04:00
The ML4W Dotfiles Uninstaller App will remove the dotfiles folder, related symbolic links and the desktop files of the ML4W Apps.
2023-12-07 15:32:32 -05:00
2024-04-01 07:37:11 -04:00
The script will also try to restore old configurations back into .config if available and restored during the installation of the ML4W Dotfiles.
2023-12-07 15:32:32 -05:00
2024-04-01 07:37:11 -04:00
## Installation in a KVM virtual machine
2023-12-07 15:32:32 -05:00
2024-04-01 07:37:11 -04:00
Qtile X11 works fine in a KVM virtual machine. The Hyprland performance is low but it's enough for testing new features.
In virt-manager please make sure that 3D acceleration is enabled in Video Virtio and the Listen type is set to None in Display Spice.
To fix the mouse issue on Hyprland, open the Hyprland settings with <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>S</kbd> and select in Environments the variation kvm.conf
2023-12-07 15:32:32 -05:00
2023-11-30 10:22:26 -05:00
## Hyprland & NVIDIA
2023-11-24 03:35:31 -05:00
There is no official Hyprland support for Nvidia hardware. However, you might make it work properly following this page.
https://wiki.hyprland.org/Nvidia/
2024-03-01 15:23:40 -05:00
Users have reported that Hyprland with dotfiles could be installed successfully on setups with NVDIA GPUs using the nouveau open source drivers.
Please select the following variation in the settings script (system/environment):
https://gitlab.com/stephan-raabe/dotfiles/-/blob/main/hypr/conf/environments/nvidia.conf
Or set the included environment variables in hyprland.conf
2024-04-01 07:37:11 -04:00
## Installation Hook
The installation script will prepare the configuration files in a folder ~/dotfiles-versions/[version] before copy the files into the final destination in ~/dotfiles
If you want to modify the installation files just before everytime the copy procedure starts, you can create a file hook.sh in the folder ~/dotfiles-versions
You can for example delete folders and files or update existing configurations.
```
#!/bin/bash
rm -rf ~/dotfiles-versions/$version/vim/
rm -rf ~/dotfiles-versions/$version/nvim/
```
This script will for example remove the vim and nvim folder before the installation. The symbolic link will not be created because the source folder doesn't exits.
You can find a template in .install/templates/hook.sh
2024-01-01 07:01:51 -05:00
## Launch Hyprland from tty
2023-12-21 07:49:33 -05:00
2024-03-01 15:23:40 -05:00
The suggested method to start Hyprland is from tty with the command Hyprland because login managers (display managers) are not officially supported (https://wiki.hyprland.org/Getting-Started/Master-Tutorial/#launching-hyprland)
2024-01-01 06:56:12 -05:00
```
2024-01-01 07:01:51 -05:00
# Start Hyprland
2024-01-01 06:56:12 -05:00
Hyprland
```
You can install a custom tty login issue (layout) with the dotfiles installer.
2024-01-01 07:01:51 -05:00
## Launch Hyprland with a Display Manager
I made good experiences with the Display Manager SDDM (https://github.com/sddm/sddm). Also gdm could work.
2023-12-21 07:49:33 -05:00
```
2024-02-25 10:47:44 -05:00
yay -S sddm
2023-12-21 07:49:33 -05:00
```
2024-02-25 10:47:44 -05:00
The dotfiles installation script will offer to deactivate the installed display manager and to activate SDDM.
2023-12-21 07:49:33 -05:00
The dotfiles package also includes a configuration for the SDDM theme sdd-sugar-candy (https://github.com/Kangie/sddm-sugar-candy) and a configuration to run SDDM in X11 mode to get the best compatibility.
With the Hyprland settings script you can copy the current wallpaper into SDDM and use it as a background.
2024-01-01 06:56:12 -05:00
Please check the troubleshooting section in case of issues.
2024-03-20 06:47:10 -04:00
## Screenlock, suspend and DPMS
2024-03-02 15:01:39 -05:00
Hypridle will start Hyprlock after 10 minutes of inactivity and will try to suspend one minutes later.
2024-03-20 06:47:10 -04:00
In the ML4W Dotfiles Settings App you can define the timeouts for Hyprlock, suspend and DPSM.
2024-03-02 15:01:39 -05:00
2024-03-03 04:57:38 -05:00
The selected hypridle configuration can be restored from the ML4W installer during a dotfiles update.
2024-04-01 07:37:11 -04:00
The ML4W Dotfiles are using the recommended configuration from https://wiki.hyprland.org/Hypr-Ecosystem/hypridle/
2023-11-27 03:44:11 -05:00
2023-11-26 10:06:51 -05:00
# Some important key bindings
2023-11-24 09:30:48 -05:00
2023-11-26 09:52:49 -05:00
- <kbd>SUPER</kbd> + <kbd>RETURN</kbd>: Alacritty
2023-12-24 08:12:10 -05:00
- <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>RETURN</kbd>: rofi application launcher
2023-11-26 09:52:49 -05:00
- <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>W</kbd>: Change wallpaper
- <kbd>SUPER</kbd> + <kbd>PRINT</kbd>: Screenshot
2023-12-24 08:12:10 -05:00
- <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>Q</kbd>: Logout screen
- <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>S</kbd>: Settings script on Hyprland
- <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>B</kbd>: Reload waybar on Hyprland
2023-11-24 09:30:48 -05:00
All keybindings for Hyprland with right mouse click on Apps in waybar or here:
2024-03-20 12:00:55 -04:00
- [Hyprland keybindings overview](hypr/conf/keybindings/default.conf)
2024-03-20 11:57:39 -04:00
- [Qtile keybindings overview](qtile/config.py)
2023-11-24 09:30:48 -05:00
2023-11-30 10:22:26 -05:00
# Hyprland
2023-11-10 16:12:15 -05:00
2024-05-02 10:17:38 -04:00
[![Screenshot](screenshots/v29/screenshot-29-2.png "Screenshot")](screenshots/v29/screenshot-29-2.png)
2023-11-10 16:12:15 -05:00
2023-01-22 12:27:01 -05:00
2024-05-02 10:17:38 -04:00
[![Screenshot](screenshots/v29/screenshot-29-3.png "Screenshot")](screenshots/v29/screenshot-29-3.png)
2024-01-29 07:32:16 -05:00
2023-11-30 10:28:34 -05:00
2024-05-04 06:36:11 -04:00
<a href="https://youtu.be/HMxHUvN6VGo" target="_blank">Watch on YouTube</a>
2023-10-18 11:40:48 -04:00
2024-04-26 08:51:10 -04:00
## ML4W Sidebar
With the ML4W Sidebar you have access to all included ML4W Applications and some system information. In addition, you start the main power features for your system.
2024-04-29 11:14:48 -04:00
You can also start the sidebar from the terminal with
```
ml4w-sidebar
```
2024-04-26 08:51:10 -04:00
<img src="screenshots/screenshot-sidebar.png" />
2024-01-25 10:33:18 -05:00
## ML4W Welcome App
2024-03-01 15:23:40 -05:00
After starting the ML4W dotfiles for the first time, the ML4W Welcome App opens. This app is the starting point to discover the Hyprland setup.
2024-01-25 10:33:18 -05:00
2024-04-29 11:14:48 -04:00
You can also start the Welcome App from the terminal with
```
ml4w
```
2024-01-25 10:33:18 -05:00
<img src="screenshots/screenshot-welcome.app.png" />
The welcome screen includes the most important keybindings to open a terminal or a browser.
2024-03-01 15:23:40 -05:00
You can start the ML4W Welcome App by clicking on the L icon on the right side in waybar, using the rofi application launcher or by typing ml4w in your terminal (if you're using the .bashrc from the dotfiles).
2024-01-25 10:33:18 -05:00
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
2024-03-07 09:51:34 -05:00
## ML4W Dotfiles Settings App
You can open the ML4W dotfiles settings app with <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>S</kbd> to change selected dotfiles configurations and choose from variations for your hyprland.conf to customize your desktop even more.
<img src="screenshots/screenshot-dotfiles-settings-app.png" />
You can create custom variations by copying a file from the ~/dotfiles/hypr/conf subfolders like monitor/default.conf, give the file a custom name (e.g., mymonitor.conf) and select the variation in the dotfiles settings app in the corresponding section.
2024-03-20 06:47:10 -04:00
> The ML4W Dotfiles Settings App replaces strings from several configuration files directly or based on replacement comments e.g., // START WORKSPACES That's why you shouldn't remove any of theses comments or markers to ensure full functionality of the app.
2024-03-18 11:12:48 -04:00
2024-03-07 09:51:34 -05:00
You can also edit the file custom.conf which is included at the bottom of the hyprland.conf and can hold you personal configurations.
2024-03-18 13:24:08 -04:00
You can find the sourcecode of the ML4W Dotfiles Settings App in this repository:
https://gitlab.com/stephan-raabe/ml4w-dotfiles-settings
2024-04-29 11:14:48 -04:00
You can also start the Dotfiles App from the terminal with
```
ml4w-settings
```
2024-04-26 08:51:10 -04:00
## ML4W Hyprland Settings App
This applications supports you to customize your Hyprland installation. You can overwrite the existing configuration with custom values without adding complex configuration files.
[![Screenshot](screenshots/screenshot-hyprland-settings.png "ML4W Hyprland Settings")](screenshots/screenshot.png)
YOu can start the application from the application launcher, the ML4W Sidebar by clicking the ML4W Logo or from the welcome app.
The app shows variables and current values of your running Hyprland.
You can change the values and overwrite the existing values. The change will be axecuted immediatly.
In the Set Variables tab you can see which values you have overwritten and can restore the old values be removing the entry.
2024-04-29 11:14:48 -04:00
You can also start the Hyprland App from the terminal with
2024-05-04 06:36:11 -04:00
2024-04-29 11:14:48 -04:00
```
ml4w-hyprland
```
2024-05-04 06:36:11 -04:00
You can find the sourcecode of the ML4W Hyprland Settings App in this repository:
https://gitlab.com/stephan-raabe/ml4w-hyprland-settings
2024-03-20 08:18:13 -04:00
## Hyprland Configuration Variations
With configuration variations, you can customize settings and configurations for your Hyprland installation. You can manage, create and edit Hyprland Configuration Variations in the ML4W Dotfiles Settings App.
<img src="https://gitlab.com/stephan-raabe/dotfiles/-/raw/main/screenshots/variations/variations1.png" />
[You can find more information here.](hypr/conf/README.md)
> Please don't edit the shipped configuration variations. These will be overwritten with every update of the ML4W dotfiles. <b>Create your own custom variation instead.</b>
2024-03-28 11:10:36 -04:00
## Wallpaper with swww or hyprpaper and Pywal
2023-11-10 16:12:15 -05:00
2023-11-30 10:19:52 -05:00
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/.
2023-11-10 16:12:15 -05:00
2023-11-30 10:19:52 -05:00
<kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>W</kbd> opens rofi with a list of installed wallpapers in ~/wallpaper/ for your individual selection.
2023-11-10 16:12:15 -05:00
2024-03-28 11:10:36 -04:00
In case of issues with swww, you can switch between the Wallpaper application swww and hyprpaper. Open the ML4W Dotfiles Settings app and select the tab system. At the top you can find the Wallpaper Engine Selector.
> PLEASE NOTE: A logout and login is required to activate the new wallpaper application.
The hyprpaper engine uses a template stored in dotfiles/.settings/hyprpaper.tpl You can add additional configurations there. The WALLPAPER placeholder will be replaced with the current wallpaper.
2023-11-30 10:22:26 -05:00
## Waybar themes and themeswitcher
2023-10-03 05:37:41 -04:00
2023-11-30 10:19:52 -05:00
In addition, you can switch the Waybar Template with <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>T</kbd> or by pressing the "..." icon in Waybar with the themeswitcher.
2023-10-03 05:37:41 -04:00
2023-11-30 10:19:52 -05:00
The templates are available in ~/dotfiles/waybar/themes. You can add your own personal themes into this folder.
2023-10-18 05:14:29 -04:00
2024-03-20 11:57:39 -04:00
[You can find more information here.](waybar/README.md)
2023-10-03 05:37:41 -04:00
2023-11-30 10:22:26 -05:00
## Screensharing and recording
2023-01-22 12:27:01 -05:00
2023-11-24 03:35:31 -05:00
More information you can find here:
https://gist.github.com/PowerBall253/2dea6ddf6974ba4e5d26c3139ffb7580
2023-11-15 02:41:58 -05:00
2024-03-20 06:47:10 -04:00
> Please note that every Arch Linux system is different and I cannot guarantee that everything works fine on your system.
2023-11-20 02:45:06 -05:00
2023-11-30 10:22:26 -05:00
## Main packages
2023-11-20 02:45:06 -05:00
2023-11-24 03:35:31 -05:00
- Terminal: alacritty
- Editor: nvim
- Prompt: starship
2024-05-04 09:10:09 -04:00
- Wallpaper: hyprpaper (swww optional)
2023-11-24 03:35:31 -05:00
- Icons: Font Awesome
2024-05-04 09:10:09 -04:00
- Launch Menus: Rofi (Wayland)
2023-11-24 03:35:31 -05:00
- Colorscheme: pywal
2024-05-04 09:10:09 -04:00
- Browsers: Chromium
2023-11-24 03:35:31 -05:00
- Filemanager: Thunar
- Cursor: Bibata Modern Ice
- Icons: Papirus-Icon-Theme
- Status Bar: waybar
- Screenshots: grim & slurp
- Clipboard Manager: cliphist
2023-11-24 09:30:48 -05:00
- Logout: wlogout
2024-02-23 07:52:27 -05:00
- Idle Manager: hypridle
- Screenlock: hyprlock
2023-11-24 09:30:48 -05:00
2023-12-20 05:19:28 -05:00
# Qtile X11
2023-11-30 10:19:52 -05:00
2023-12-21 07:51:10 -05:00
<a href="https://youtu.be/e9ro_P9rbFk" target="_blank"><img src="screenshots/v27/screenshot-27-3.png" alt="Click to watch on YouTube" /></a>
2023-11-30 10:19:52 -05:00
2023-12-21 07:51:10 -05:00
<a href="https://youtu.be/e9ro_P9rbFk" target="_blank"><img src="screenshots/v27/screenshot-27-4.png" alt="Click to watch on YouTube" /></a>
2023-11-30 10:19:52 -05:00
2023-11-30 10:22:26 -05:00
## Wallpaper and Pywal
2023-11-30 10:19:52 -05:00
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/.
<kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>W</kbd> opens rofi with a list of installed wallpapers in ~/wallpaper/ for your individual selection.
2023-11-30 10:22:26 -05:00
## Main Packages
2023-11-30 10:19:52 -05:00
- Terminal: alacritty
- Editor: nvim
- Prompt: starship
- Icons: Font Awesome
2024-05-04 09:10:09 -04:00
- Launch Menus: Rofi
2023-11-30 10:19:52 -05:00
- Colorscheme: pywal
2024-05-04 09:10:09 -04:00
- Browsers: Chromium
2023-11-30 10:19:52 -05:00
- Filemanager: Thunar
- Cursor: Bibata Modern Ice
- Icons: Papirus-Icon-Theme
2024-01-06 07:31:16 -05:00
- Status Bar: Qtile status bar
2024-05-04 09:10:09 -04:00
- Compositor: picom (optional)
2023-11-30 10:19:52 -05:00
- Screenshots: scrot
2024-03-28 11:10:36 -04:00
# Installation/Update with GIT
## Installation with GIT
You can also install the dotfiles by cloning the latest main release:
```
# 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://gitlab.com/stephan-raabe/dotfiles.git
# 3.) Change into the dotfiles folder
cd dotfiles
# 4.) Start the installation
./install.sh
```
## Installation with GIT (Rolling release)
You can install the dotfiles by cloning the latest development version from the rolling release:
```
# 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 https://gitlab.com/stephan-raabe/dotfiles.git
# 3.) Change into the new dotfiles folder
cd dotfiles
# 4.) Checkout the dev branch
git checkout dev
# 4.) Start the installation
./install.sh
```
## Update with GIT
Please follow the steps to update from earlier dotfiles versions to 2.8.3
```
# 1.) Remove existing downloaded dotfiles
rm -rf ~/Downloads/dotfiles
# 2.) Change into your Downloads folder
cd ~/Downloads
# 3.) Clone the dotfiles repository into the Downloads folder
git clone --depth=1 https://gitlab.com/stephan-raabe/dotfiles.git
# 4.) Change into the dotfiles folder
cd dotfiles
# 5.) Start the installation
./install.sh
```
# Base Hyprland installation with Hyperland Starter Package
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
2024-01-25 10:33:18 -05:00
# Troubleshooting
2024-05-04 06:36:11 -04:00
The ML4W Welcome App includes a system diagnosis feature available in the menu with the three dots.
2024-03-27 09:11:45 -04:00
2024-05-04 06:36:11 -04:00
Please run the diagnosis to see if all essential packages and related commands are available on your system.
2024-03-27 09:11:45 -04:00
2024-05-04 06:36:11 -04:00
If not, you need to install the missing packages manually.
## rofi (application launcher) is not working
If the installation of rofi-wayland fails in the installation/update procedure please try to install it manually:
2024-03-27 09:11:45 -04:00
```
2024-05-04 06:36:11 -04:00
yay -S rofi-wayland
2024-03-27 09:11:45 -04:00
```
2024-05-04 06:36:11 -04:00
If rofi-wayland isn't available please try rofi:
2024-03-27 09:11:45 -04:00
2024-05-04 06:36:11 -04:00
```
yay -S rofi
```
2024-03-20 05:47:10 -04:00
2024-02-27 09:01:00 -05:00
## hypridle and hyprlock is not starting after an update of the dotfiles
Please make sure that hypridle and hyprlock has been installed successfully with
```
yay -S hypridle hyprlock
```
If there is an file conflict the remove the files manually with:
```
sudo rm /usr/lib/debug/usr/bin/hypridle.debug
sudo rm /usr/lib/debug/usr/bin/hyprlock.debug
```
and start the installation again with
```
yay -S hypridle hyprlock
```
2024-01-25 10:33:18 -05:00
## 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
```
2024-02-23 03:05:14 -05:00
## Waybar is not loading
2024-03-29 05:15:48 -04:00
There could be a conflict with xdg-desktop-portal-gtk or xdg-desktop-portal-gnome. Please try to remove the package if installed with:
2024-02-23 03:05:14 -05:00
```
sudo pacman -R xdg-desktop-portal-gtk
```
2023-11-30 10:22:26 -05:00
# Wallpaper repository
2023-01-22 12:27:01 -05:00
2023-12-23 11:12:53 -05:00
You can find my wallpaper collection in the repository https://gitlab.com/stephan-raabe/wallpaper
# Special Thanks
THANK YOU very much for all your support, contributions and ideas:
- Diana Ward: https://github.com/dianaw353
2023-12-24 04:28:32 -05:00
- Don Williams: https://github.com/dwilliam62
2023-12-23 11:12:53 -05:00
- Teodor Orzechowski: https://gitlab.com/sq6gtt
2023-12-24 04:31:39 -05:00
- Jamie Deppeler: https://gitlab.com/bknight2k
2023-12-24 04:28:32 -05:00
2023-12-23 11:12:53 -05:00
and many more...
Thanks to all YouTube subscribers for all your great feedback.
# Inspirations
The following projects have inspired me:
- https://github.com/dianaw353/hyprland-configuration-rootfs
- https://github.com/prasanthrangan/hyprdots
- https://github.com/sudo-harun/dotfiles
2023-12-24 04:28:32 -05:00
and many more...