Hyprland-dotfiles/README.md

191 lines
7.1 KiB
Markdown
Raw Normal View History

2023-11-26 04:44:19 -05:00
# ML4W dotfiles 2.6
2023-01-22 12:27:01 -05:00
2023-11-26 09:52:49 -05:00
This is my configuration of Hyprland (Wayland) and Qtile (Xorg & Wayland) for Arch. This package includes an installation script to install and setup the required components.
2023-10-18 11:39:51 -04:00
2023-11-26 09:55:15 -05:00
PLEASE NOTE: This branch is the rolling release of my dotfiles and includes the latest changes.
Please be aware that this version is not a tested release.
2023-11-21 01:36:23 -05:00
The released dotfiles are tested with Arch Linux, Manjaro Linux, EndeavourOS and Arco Linux.
2023-08-31 09:01:03 -04:00
2023-11-14 14:53:27 -05:00
You can find the video on YouTube: <a href="https://youtu.be/5i_LMMXUDJI" target="_blank">Dotfiles Configuration and Installation</a>
2023-11-24 03:35:31 -05:00
## Installation
2023-04-06 08:49:57 -04:00
2023-11-24 03:35:31 -05:00
To make it easy for you to get started with my dotfiles, here's a list of recommended next steps.
2023-11-24 09:30:48 -05:00
The script will try to create a backup from an previous dotfiles installation.
2023-11-26 09:55:15 -05:00
PLEASE BACKUP YOUR EXISTING .config FOLDER WITH YOUR DOTFILES BEFORE STARTING THE SCRIPTS FOR INITIONAL INSTALLTION.
PLEASE READ THIS README until the end before starting the installation.
2023-08-31 09:01:03 -04:00
2023-11-24 03:35:31 -05:00
### Installation with GIT (Rolling Release of main branch)
2023-08-31 09:01:03 -04:00
2023-11-24 03:35:31 -05:00
```
# 1.) Change into your Downloads folder
cd ~/Downloads
# 2.) Clone the dotfiles repository into the Downloads folder
git clone https://gitlab.com/stephan-raabe/dotfiles.git
# 3.) Change into the dotfiles folder
cd dotfiles
# 4.) Start the installation
./install.sh
2023-11-26 04:44:19 -05:00
```
### Update with GIT (Rolling Release of main branch)
2023-11-26 07:27:11 -05:00
```
# 1.) Change into your Downloads folder
cd ~/Downloads/dotfiles
# 2.) Pull the latest version and update the repository
git stash; git pull
# 3.) Start the installation to update
./install.sh
```
### Update with GIT (Rolling Release of main branch)
You can also update by deleting the ~/Downloads/dotfiles folder and clone again.
2023-11-26 04:44:19 -05:00
```
# 1.) Change into your Downloads folder
cd ~/Downloads
2023-11-26 05:28:25 -05:00
# 2.) Delete existing dotfiles folder from Downloads folder
rm -rf ~/Downloads/dotfiles
2023-11-26 04:44:19 -05:00
# 3.) Clone the dotfiles repository into the Downloads folder
git clone https://gitlab.com/stephan-raabe/dotfiles.git
# 4.) Change into the dotfiles folder
cd dotfiles
# 5.) Start the installation to update
./install.sh
2023-11-24 03:35:31 -05:00
```
2023-11-26 07:34:37 -05:00
### Installation by downloading the latest release
2023-11-24 03:35:31 -05:00
2023-11-26 07:34:37 -05:00
If you don't want to use the rolling release, you can download the latest release the latest release https://gitlab.com/stephan-raabe/dotfiles/-/releases or choose the the latest tag https://gitlab.com/stephan-raabe/dotfiles/-/tags and download the zip.
```
# 1.) Change into your Downloads folder where you have downloaded the release to
cd ~/Downloads
# 2.) Unzip
unzip dotfiles-2.6.zip
# 3.) Change into the new dotfiles folder
cd dotfiles-2.6
# 4.) Start the installation to update
./install.sh
```
2023-11-24 03:35:31 -05:00
2023-11-24 09:30:48 -05:00
You can also use the dotfiles installer script to download and install the latest release: https://gitlab.com/stephan-raabe/installer
2023-11-24 03:35:31 -05:00
### NVIDIA
There is no official Hyprland support for Nvidia hardware. However, you might make it work properly following this page.
https://wiki.hyprland.org/Nvidia/
That's why NVIDIA GPUs are currently not supported by my dotfiles. But in upcoming releases, I will try to setup Hyprland for NVIDIA based on the article above.
2023-08-31 09:01:03 -04:00
2023-11-24 09:30:48 -05:00
## Some important key bindings
2023-11-26 09:52:49 -05:00
- <kbd>SUPER</kbd> + <kbd>RETURN</kbd>: Alacritty
- <kbd>SUPER</kbd> + <kbd>CMD</kbd> + <kbd>RETURN</kbd>: rofi application launcher
- <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>W</kbd>: Change wallpaper
- <kbd>SUPER</kbd> + <kbd>PRINT</kbd>: Screenshot
- <kbd>SUPER</kbd> + <kbd>CMS</kbd> + <kbd>Q</kbd>: Logout screen
2023-11-24 09:30:48 -05:00
All keybindings for Hyprland with right mouse click on Apps in waybar or here:
https://gitlab.com/stephan-raabe/dotfiles/-/blob/main/hypr/conf/keybindings.conf?ref_type=heads
All keybindings for Qtile: https://gitlab.com/stephan-raabe/dotfiles/-/blob/main/qtile/config.py?ref_type=heads
2023-11-24 07:20:04 -05:00
## Templating & Settings
2023-04-06 08:49:57 -04:00
2023-11-24 07:20:04 -05:00
Hyprland & Qtile: Included is a pywal configuration that changes the color scheme based on a randomly selected wallpaper. With the key binding SuperKey + Shift + W you can change the wallpaper. SuperKey + Ctrl + W opens rofi with a list of installed wallpapers for your individual selection. See also the .bashrc and the key bindings on Hyprland and Qtile for more alias definitions.
2023-02-18 11:02:06 -05:00
2023-11-24 07:20:04 -05:00
Hyprland: In addition, you can switch the Waybar Template with SUPER + CTRL + T or by pressing the "..." icon in Waybar. The templates are available in ~/dotfiles/waybar/themes. You can add your own personal themes into this folder. The script will read in the folder structure. You can open the settings script with SUPER + CMD + S to select variations for your hyprland.conf and customize your desktop even more.
2023-10-17 11:31:46 -04:00
2023-11-10 16:12:15 -05:00
Qtile X11: In addition, you can switch between the Qtile status bar and Polybar with SUPER + SHIFT + S
## Screenshots Hyprland
2023-11-23 09:52:36 -05:00
<a href="https://youtu.be/5i_LMMXUDJI" target="_blank"><img src="screenshots/v26/screenshot-26-1.png" alt="Click to watch on YouTube" /></a>
2023-11-10 16:12:15 -05:00
2023-11-23 09:52:36 -05:00
<a href="https://youtu.be/5i_LMMXUDJI" target="_blank"><img src="screenshots/v26/screenshot-26-2.png" alt="Click to watch on YouTube" /></a>
2023-01-22 12:27:01 -05:00
2023-11-14 14:53:27 -05:00
<a href="https://youtu.be/5i_LMMXUDJI" target="_blank">Watch on YouTube</a>
2023-10-18 11:40:48 -04:00
2023-11-10 16:12:15 -05:00
## Screenshots Qtile X11
2023-11-14 14:53:27 -05:00
<a href="https://youtu.be/5i_LMMXUDJI" target="_blank"><img src="screenshots/v25/screenshot-25-3.png" alt="Click to watch on YouTube" /></a>
2023-11-10 16:12:15 -05:00
2023-11-14 14:53:27 -05:00
<a href="https://youtu.be/5i_LMMXUDJI" target="_blank"><img src="screenshots/v25/screenshot-25-4.png" alt="Click to watch on YouTube" /></a>
2023-11-10 16:12:15 -05:00
2023-11-14 14:53:27 -05:00
<a href="https://youtu.be/5i_LMMXUDJI" target="_blank">Watch on YouTube</a>
2023-10-03 05:37:41 -04:00
2023-11-10 16:12:15 -05:00
## Screenshots Qtile Wayland
2023-10-03 05:37:41 -04:00
2023-11-14 14:53:27 -05:00
<a href="https://youtu.be/5i_LMMXUDJI" target="_blank"><img src="screenshots/v25/screenshot-25-1.png" alt="Click to watch on YouTube" /></a>
2023-10-18 05:14:29 -04:00
2023-11-14 14:53:27 -05:00
<a href="https://youtu.be/5i_LMMXUDJI" target="_blank"><img src="screenshots/v25/screenshot-25-2.png" alt="Click to watch on YouTube" /></a>
2023-10-03 05:37:41 -04:00
2023-11-14 14:53:27 -05:00
<a href="https://youtu.be/5i_LMMXUDJI" target="_blank">Watch on YouTube</a>
2023-08-31 12:11:09 -04:00
2023-08-31 12:12:40 -04:00
<b><a href="https://gitlab.com/stephan-raabe/dotfiles/-/tree/main/screenshots?ref_type=heads">You can find more screenshots here.</a></b>
2023-01-22 12:27:01 -05:00
2023-11-24 03:35:31 -05:00
## Please note
2023-01-22 12:27:01 -05:00
2023-11-24 03:35:31 -05:00
In case you have issues with starting Waybar please make sure that only one xdg-desktop-portal-x is installed additionally to xdg-desktop-portal.
2023-09-05 00:31:24 -04:00
2023-11-24 03:35:31 -05:00
I had several issues with xdg-desktop-portal-wlr on Hyprland and Waybar. Please make sure that xdg-desktop-portal-wlr is uninstalled and xdg-desktop-portal-hyprland is installed.
2023-09-04 16:20:21 -04: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
2023-11-24 03:35:31 -05: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-24 03:35:31 -05:00
## General Packages
2023-11-20 02:45:06 -05:00
2023-11-24 03:35:31 -05:00
- Terminal: alacritty
- Editor: nvim
- Prompt: starship
- Icons: Font Awesome
- Launch Menus: Rofi
- Colorscheme: pywal
- Browsers: chromium (brave optional)
- Filemanager: Thunar
- Cursor: Bibata Modern Ice
- Icons: Papirus-Icon-Theme
2023-11-20 02:45:06 -05:00
2023-11-24 09:30:48 -05:00
## Hyprland
2023-11-20 02:45:06 -05:00
2023-11-24 03:35:31 -05:00
- Status Bar: waybar
- Screenshots: grim & slurp
- Clipboard Manager: cliphist
2023-11-24 09:30:48 -05:00
- Logout: wlogout
- Screenlock: swaylock-effects
## Qtile Wayland
- Status Bar: Qtile status bar
- Screenshots: grim & slurp
- Clipboard Manager: cliphist
- Logout: rofi power menu
2023-11-24 03:35:31 -05:00
- Screenlock: swaylock-effects
2023-11-20 02:45:06 -05:00
2023-11-24 03:35:31 -05:00
## Qtile X11
2023-01-22 12:27:01 -05:00
2023-11-24 03:35:31 -05:00
- Compositor: picom
- Status Bar: Qtile status bar + Polybar (optional)
- Screenshots: scrot