hyprdots

<div align="right">_{// design by t2}</div>

<div align = center> <a href="https://discord.gg/AYbJ9MJez7"> <img alt="Dynamic JSON Badge" src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscordapp.com%2Fapi%2Finvites%2FmT5YqjaJFh%3Fwith_counts%3Dtrue&query=%24.approximate_member_count&suffix=%20members&style=for-the-badge&logo=discord&logoSize=auto&label=The%20HyDe%20Project&labelColor=ebbcba&color=c79bf0"> </a> </div> <!-- <img alt="Dynamic JSON Badge" src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscordapp.com%2Fapi%2Finvites%2FmT5YqjaJFh%3Fwith_counts%3Dtrue&query=%24.approximate_member_count&suffix=%20members&style=for-the-badge&logo=discord&logoSize=auto&label=The%20HyDe%20Project&labelColor=ebbcba&color=c79bf0"> <img alt="Dynamic JSON Badge" src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fdiscordapp.com%2Fapi%2Finvites%2FmT5YqjaJFh%3Fwith_counts%3Dtrue&query=%24.approximate_presence_count&suffix=%20online&style=for-the-badge&logo=discord&logoSize=auto&label=The%20HyDe%20Project&labelColor=ebbcba&color=c79bf0"> --> <div align="center">

<br>

<a href="#installation"><kbd> <br> Installation <br> </kbd></a>   <a href="#themes"><kbd> <br> Themes <br> </kbd></a>   <a href="#styles"><kbd> <br> Styles <br> </kbd></a>   <a href="#keybindings"><kbd> <br> Keybindings <br> </kbd></a>   <a href="https://www.youtube.com/watch?v=2rWqdKU1vu8&list=PLt8rU_ebLsc5yEHUVsAQTqokIBMtx3RFY&index=1"><kbd> <br> Youtube <br> </kbd></a>   <a href="https://github.com/prasanthrangan/hyprdots/wiki"><kbd> <br> Wiki <br> </kbd></a>   <a href="https://discord.gg/qWehcFJxPa"><kbd> <br> Discord <br> </kbd></a>

</div><br><br>

https://github.com/prasanthrangan/hyprdots/assets/106020512/7f8fadc8-e293-4482-a851-e9c6464f5265

<br><div align="center"><img width="12%" src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/arch.png"/><br></div>

Installation

The installation script is designed for a minimal Arch Linux install, but may work on some Arch-based distros. While installing HyDE alongside another DE/WM should work, due to it being a heavily customized setup, it will conflict with your GTK/Qt theming, Shell, SDDM, GRUB, etc. and is at your own risk.

[!IMPORTANT] The install script will auto-detect an NVIDIA card and install nvidia-dkms drivers for your kernel. Please ensure that your NVIDIA card supports dkms drivers in the list provided here.

[!CAUTION] The script modifies your grub or systemd-boot config to enable NVIDIA DRM.

To install, execute the following commands:

pacman -Sy git
git clone --depth 1 https://github.com/prasanthrangan/hyprdots ~/HyDE
cd ~/HyDE/Scripts
./install.sh

[!TIP] You can also add any other apps you wish to install alongside HyDE to Scripts/custom_apps.lst and pass the file as a parameter to install it like so:

./install.sh custom_apps.lst

As a second install option, you can also use Hyde-install, which might be easier for some. View installation instructions for HyDE in Hyde-cli - Usage.

Please reboot after the install script completes and takes you to the SDDM login screen (or black screen) for the first time. For more details, please refer to the installation wiki.

Updating

To update HyDE, you will need to pull the latest changes from GitHub and restore the configs by running the following commands:

cd ~/HyDE/Scripts
git pull
./install.sh -r

[!IMPORTANT] Please note that any configurations you made will be overwritten if listed to be done so as listed by Scripts/restore_cfg.lst. However, all replaced configs are backed up and may be recovered from in ~/.config/cfg_backups.

As a second update option, you can use Hyde restore ..., which does have a better way of managing restore and backup options. For more details, you can refer to Hyde-cli - dots management wiki.

<div align="right"> <br> <a href="#-design-by-t2"><kbd> <br> 🡅 <br> </kbd></a> </div>

Themes

All our official themes are stored in a separate repository, allowing users to install them using themepatcher. For more information, visit prasanthrangan/hyde-themes.

<div align="center"> <table><tr><td>

</td></tr></table> </div>

[!TIP] Everyone, including you can create, maintain, and share additional themes, all of which can be installed using themepatcher! To create your own custom theme, please refer to the theming wiki. If you wish to have your hyde theme showcased, or you want to find some non-official themes, visit kRHYME7/hyde-gallery!

<div align="right"> <br> <a href="#-design-by-t2"><kbd> <br> 🡅 <br> </kbd></a> </div>

Styles

<div align="center"><table><tr>Theme Select</tr><tr><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/theme_select_1.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/theme_select_2.png"/></td></tr></table></div> <div align="center"><table><tr><td>Wallpaper Select</td><td>Launcher Select</td></tr><tr><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/walls_select.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_sel.png"/></td></tr> <tr><td>Wallbash Modes</td><td>Notification Action</td></tr><tr><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/wb_mode_sel.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/notif_action_sel.png"/></td></tr> </table></div> <div align="center"><table><tr>Rofi Launcher</tr><tr><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_1.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_2.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_3.png"/></td></tr><tr><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_4.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_5.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_6.png"/></td></tr><tr><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_7.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_8.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_9.png"/></td></tr><tr><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_10.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_11.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/rofi_style_12.png"/></td></tr> </table></div> <div align="center"><table><tr>Wlogout Menu</tr><tr><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/wlog_style_1.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/wlog_style_2.png"/></td></tr></table></div> <div align="center"><table><tr>Game Launcher</tr><tr><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/game_launch_1.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/game_launch_2.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/game_launch_3.png"/></td></tr></table></div> <div align="center"><table><tr><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/game_launch_4.png"/></td><td> <img src="https://raw.githubusercontent.com/prasanthrangan/hyprdots/main/Source/assets/game_launch_5.png"/></td></tr></table></div> <div align="right"> <br> <a href="#-design-by-t2"><kbd> <br> 🡅 <br> </kbd></a> </div>

Keybindings

<div align="center">

Keys	Action
<kbd>Super</kbd> + <kbd>Q</kbd><br><kbd>Alt</kbd> + <kbd>F4</kbd>	Close focused window
<kbd>Super</kbd> + <kbd>Del</kbd>	Kill Hyprland session
<kbd>Super</kbd> + <kbd>W</kbd>	Toggle the window between focus and float
<kbd>Super</kbd> + <kbd>G</kbd>	Toggle the window between focus and group
<kbd>Super</kbd> + <kbd>slash</kbd>	Launch keybinds hint
<kbd>Alt</kbd> + <kbd>Enter</kbd>	Toggle the window between focus and fullscreen
<kbd>Super</kbd> + <kbd>L</kbd>	Launch lock screen
<kbd>Super</kbd> + <kbd>Shift</kbd> + <kbd>F</kbd>	Toggle pin on focused window
<kbd>Super</kbd> + <kbd>Backspace</kbd>	Launch logout menu
<kbd>Ctrl</kbd> + <kbd>Esc</kbd>	Toggle waybar
<kbd>Super</kbd> + <kbd>T</kbd>	Launch terminal emulator (kitty)
<kbd>Super</kbd> + <kbd>E</kbd>	Launch file manager (dolphin)
<kbd>Super</kbd> + <kbd>C</kbd>	Launch text editor (vscode)
<kbd>Super</kbd> + <kbd>F</kbd>	Launch web browser (firefox)
<kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Esc</kbd>	Launch system monitor (htop/btop or fallback to top)
<kbd>Super</kbd> + <kbd>A</kbd>	Launch application launcher (rofi)
<kbd>Super</kbd> + <kbd>Tab</kbd>	Launch window switcher (rofi)