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

###### _<div align="right"><a id=-design-by-t2></a><sub>// design by t2</sub></div>_

![hyde_banner](Source/assets/hyde_banner.png)

<!--
Multi-language KEYBINDINGS support
-->

<!-- [![en](https://img.shields.io/badge/lang-en-red.svg)](KEYBINDINGS.md) -->

[![es](https://img.shields.io/badge/lang-es-yellow.svg)](Source/assets/keybinds/KEYBINDINGS.es.md)
[![de](https://img.shields.io/badge/lang-de-black.svg)](Source/assets/keybinds/KEYBINDINGS.de.md)
[![nl](https://img.shields.io/badge/lang-nl-green.svg)](Source/assets/keybinds/KEYBINDINGS.nl.md)
[![中文](https://img.shields.io/badge/lang-中文-orange.svg)](Source/assets/keybinds/KEYBINDINGS.zh.md)
[![fr](https://img.shields.io/badge/lang-fr-blue.svg)](Source/assets/keybinds/KEYBINDINGS.fr.md)
[![ar](https://img.shields.io/badge/lang-AR-orange.svg)](Source/assets/keybinds/KEYBINDINGS.ar.md)

<div align="center">

<br>

<!-- <a href=#hyde-keybindings><kbd> <br> HyDE keybindings <br> </kbd></a>&ensp;&ensp; -->

<a href=#window-management><kbd> <br> Window Management <br> </kbd></a>&ensp;&ensp;
<a href=#misc><kbd> <br> Misc <br> </kbd></a>&ensp;&ensp;
<a href=#launcher><kbd> <br> Launcher <br> </kbd></a>&ensp;&ensp;
<a href=#hardware-controls><kbd> <br> Hardware Controls <br> </kbd></a>&ensp;&ensp;
<a href=#utilities><kbd> <br> Utilities <br> </kbd></a>&ensp;&ensp;
<a href="#theming-and-wallpaper"><kbd> <br> Theming and Wallpaper <br> </kbd></a>&ensp;&ensp;
<a href=#workspaces><kbd> <br> Workspaces <br> </kbd></a>&ensp;&ensp;

</div><br><br>

<div align="center">
  <div style="display: flex; flex-wrap: nowrap; justify-content: center;">
    <img src="Source/assets/archlinux.png" alt="Arch Linux" style="width: 10%; margin: 10px;"/>
    <img src="Source/assets/cachyos.png" alt="CachyOS" style="width: 10%; margin: 10px;"/>
    <img src="Source/assets/endeavouros.png" alt="EndeavourOS" style="width: 10%; margin: 10px;"/>
    <img src="Source/assets/garuda.png" alt="Garuda" style="width: 10%; margin: 10px;"/>
    <img src="Source/assets/nixos.png" alt="NixOS" style="width: 10%; margin: 10px;"/>
  </div>
</div>

<!-- # <a id=hyde-keybindings>HyDE Keybindings</a> -->
<!-- # <a id=hyde-keybindings></a><img src="https://readme-typing-svg.herokuapp.com?font=Lexend+Giga&size=25&pause=1000&color=CCA9DD&width=435&lines=HyDE%20Keybindings" width="450"/> -->

Here are all HyDE specific keybindings listed.

> [!TIP]  
> <kbd>Super</kbd> + <kbd>/</kbd> shows the keybindings.

<!-- ## <a id=window-management>Window Management</a> -->

## <a id=window-management></a><img src="https://readme-typing-svg.herokuapp.com?font=Lexend+Giga&size=23&pause=1000&color=CCA9DD&width=435&lines=Window%20Management" width="450"/>

| Keys                                                 | Action                          |
| :--------------------------------------------------- | :------------------------------ |
| <kbd>CTRL</kbd> + <kbd>Q</kbd>                       | close focused window            |
| <kbd>ALT</kbd> + <kbd>F4</kbd>                       | close focused window            |
| <kbd>SUPER</kbd> + <kbd>Delete</kbd>                 | kill hyprland session           |
| <kbd>SUPER</kbd> + <kbd>W</kbd>                      | toggle float                    |
| <kbd>SUPER</kbd> + <kbd>G</kbd>                      | toggle group                    |
| <kbd>Shift</kbd> + <kbd>F11</kbd>                    | toggle fullscreen               |
| <kbd>SUPER</kbd> + <kbd>L</kbd>                      | lock screen                     |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>F</kbd>   | toggle pin on focused window    |
| <kbd>ALT</kbd> + <kbd>CTRL</kbd> + <kbd>Delete</kbd> | logout menu                     |
| <kbd>ALT</kbd> + <kbd>Control_R</kbd>                | toggle waybar and reload config |
| <kbd>SUPER</kbd> + <kbd>J</kbd>                      | toggle split                    |

### Group Navigation

| Keys                                              | Action                        |
| :------------------------------------------------ | :---------------------------- |
| <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>H</kbd> | change active group backwards |
| <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>L</kbd> | change active group forwards  |

### Change focus

| Keys                                | Action      |
| :---------------------------------- | :---------- |
| <kbd>SUPER</kbd> + <kbd>Left</kbd>  | focus left  |
| <kbd>SUPER</kbd> + <kbd>Right</kbd> | focus right |
| <kbd>SUPER</kbd> + <kbd>Up</kbd>    | focus up    |
| <kbd>SUPER</kbd> + <kbd>Down</kbd>  | focus down  |
| <kbd>ALT</kbd> + <kbd>Tab</kbd>     | cycle focus |

### Resize Active Window

| Keys                                                   | Action              |
| :----------------------------------------------------- | :------------------ |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>Right</kbd> | resize window right |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>Left</kbd>  | resize window left  |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>Up</kbd>    | resize window up    |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>Down</kbd>  | resize window down  |

### Move & Resize with mouse

| Keys                                    | Action                |
| :-------------------------------------- | :-------------------- |
| <kbd>SUPER</kbd> + <kbd>mouse:272</kbd> | hold to move window   |
| <kbd>SUPER</kbd> + <kbd>mouse:273</kbd> | hold to resize window |
| <kbd>SUPER</kbd> + <kbd>Z</kbd>         | hold to move window   |
| <kbd>SUPER</kbd> + <kbd>X</kbd>         | hold to resize window |

<!-- ## <a id=misc>Misc</a> -->

## <a id=misc></a><img src="https://readme-typing-svg.herokuapp.com?font=Lexend+Giga&size=23&pause=1000&color=CCA9DD&width=435&lines=Misc" width="450"/>

| Keys                                                                     | Action                         |
| :----------------------------------------------------------------------- | :----------------------------- |
| <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>SHIFT</kbd> + <kbd>left</kbd>  | move activewindow to the left  |
| <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>SHIFT</kbd> + <kbd>right</kbd> | move activewindow to the right |
| <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>SHIFT</kbd> + <kbd>up</kbd>    | move activewindow up           |
| <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>SHIFT</kbd> + <kbd>down</kbd>  | move activewindow down         |

<!-- ## <a id=launcher>Launcher</a> -->

## <a id=launcher></a><img src="https://readme-typing-svg.herokuapp.com?font=Lexend+Giga&size=23&pause=1000&color=CCA9DD&width=435&lines=Launcher" width="450"/>

### Apps

| Keys                                                   | Action            |
| :----------------------------------------------------- | :---------------- |
| <kbd>SUPER</kbd> + <kbd>T</kbd>                        | terminal emulator |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>T</kbd>       | dropdown terminal |
| <kbd>SUPER</kbd> + <kbd>E</kbd>                        | file explorer     |
| <kbd>SUPER</kbd> + <kbd>C</kbd>                        | text editor       |
| <kbd>SUPER</kbd> + <kbd>B</kbd>                        | web browser       |
| <kbd>CTRL</kbd> + <kbd>SHIFT</kbd> + <kbd>Escape</kbd> | system monitor    |

### Rofi menus

| Keys                                               | Action               |
| :------------------------------------------------- | :------------------- |
| <kbd>SUPER</kbd> + <kbd>A</kbd>                    | application finder   |
| <kbd>SUPER</kbd> + <kbd>TAB</kbd>                  | window switcher      |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>E</kbd> | file finder          |
| <kbd>SUPER</kbd> + <kbd>slash</kbd>                | keybindings hint     |
| <kbd>SUPER</kbd> + <kbd>comma</kbd>                | emoji picker         |
| <kbd>SUPER</kbd> + <kbd>period</kbd>               | glyph picker         |
| <kbd>SUPER</kbd> + <kbd>V</kbd>                    | clipboard            |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>V</kbd> | clipboard manager    |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>A</kbd> | select rofi launcher |

<!-- ## <a id="hardware-controls">Hardware Controls</a> -->

## <a id="hardware-controls"></a><img src="https://readme-typing-svg.herokuapp.com?font=Lexend+Giga&size=23&pause=1000&color=CCA9DD&width=435&lines=Hardware%20Controls" width="450"/>

### Audio

| Keys                                              | Action             |
| :------------------------------------------------ | :----------------- |
| <kbd>None</kbd> + <kbd>F10</kbd>                  | toggle mute output |
| <kbd>None</kbd> + <kbd>XF86AudioMute</kbd>        | toggle mute output |
| <kbd>None</kbd> + <kbd>F11</kbd>                  | decrease volume    |
| <kbd>None</kbd> + <kbd>F12</kbd>                  | increase volume    |
| <kbd>None</kbd> + <kbd>XF86AudioMicMute</kbd>     | un/mute microphone |
| <kbd>None</kbd> + <kbd>XF86AudioLowerVolume</kbd> | decrease volume    |
| <kbd>None</kbd> + <kbd>XF86AudioRaiseVolume</kbd> | increase volume    |

### Media

| Keys                                        | Action         |
| :------------------------------------------ | :------------- |
| <kbd>None</kbd> + <kbd>XF86AudioPlay</kbd>  | play media     |
| <kbd>None</kbd> + <kbd>XF86AudioPause</kbd> | pause media    |
| <kbd>None</kbd> + <kbd>XF86AudioNext</kbd>  | next media     |
| <kbd>None</kbd> + <kbd>XF86AudioPrev</kbd>  | previous media |

### Brightness

| Keys                                               | Action              |
| :------------------------------------------------- | :------------------ |
| <kbd>None</kbd> + <kbd>XF86MonBrightnessUp</kbd>   | increase brightness |
| <kbd>None</kbd> + <kbd>XF86MonBrightnessDown</kbd> | decrease brightness |

<!-- ## <a id=utilities>Utilities</a> -->

## <a id=utilities></a><img src="https://readme-typing-svg.herokuapp.com?font=Lexend+Giga&size=23&pause=1000&color=CCA9DD&width=435&lines=Utilities" width="450"/>

| Keys                                             | Action                 |
| :----------------------------------------------- | :--------------------- |
| <kbd>SUPER</kbd> + <kbd>K</kbd>                  | toggle keyboard layout |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>G</kbd> | game mode              |

### Screen Capture

| Keys                                               | Action                 |
| :------------------------------------------------- | :--------------------- |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>P</kbd> | color picker           |
| <kbd>SUPER</kbd> + <kbd>P</kbd>                    | snip screen            |
| <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>P</kbd>  | freeze and snip screen |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>P</kbd>   | print monitor          |
| <kbd>None</kbd> + <kbd>Print</kbd>                 | print all monitors     |

<!-- ## <a id=theming-and-wallpaper>Theming and Wallpaper</a> -->

## <a id=theming-and-wallpaper></a><img src="https://readme-typing-svg.herokuapp.com?font=Lexend+Giga&size=23&pause=1000&color=CCA9DD&width=435&lines=Theming%20and%20Wallpaper" width="450"/>

| Keys                                                 | Action                 |
| :--------------------------------------------------- | :--------------------- |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>Right</kbd> | next wallpaper         |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>Left</kbd>  | previous wallpaper     |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>W</kbd>   | select a wallpaper     |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>Up</kbd>    | next waybar layout     |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>Down</kbd>  | previous waybar layout |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>R</kbd>   | wallbash mode selector |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>T</kbd>   | select a theme         |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>Y</kbd>   | select animations      |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>U</kbd>   | select hyprlock layout |

<!-- ## <a id=workspaces>Workspaces</a> -->

## <a id=workspaces></a><img src="https://readme-typing-svg.herokuapp.com?font=Lexend+Giga&size=23&pause=1000&color=CCA9DD&width=435&lines=Workspaces" width="450"/>

### Navigation

| Keys                                                 | Action                                  |
| :--------------------------------------------------- | :-------------------------------------- |
| <kbd>SUPER</kbd> + <kbd>1</kbd>                      | navigate to workspace 1                 |
| <kbd>SUPER</kbd> + <kbd>2</kbd>                      | navigate to workspace 2                 |
| <kbd>SUPER</kbd> + <kbd>3</kbd>                      | navigate to workspace 3                 |
| <kbd>SUPER</kbd> + <kbd>4</kbd>                      | navigate to workspace 4                 |
| <kbd>SUPER</kbd> + <kbd>5</kbd>                      | navigate to workspace 5                 |
| <kbd>SUPER</kbd> + <kbd>6</kbd>                      | navigate to workspace 6                 |
| <kbd>SUPER</kbd> + <kbd>7</kbd>                      | navigate to workspace 7                 |
| <kbd>SUPER</kbd> + <kbd>8</kbd>                      | navigate to workspace 8                 |
| <kbd>SUPER</kbd> + <kbd>9</kbd>                      | navigate to workspace 9                 |
| <kbd>SUPER</kbd> + <kbd>0</kbd>                      | navigate to workspace 10                |
| <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>Down</kbd> | navigate to the nearest empty workspace |
| <kbd>SUPER</kbd> + <kbd>mouse_down</kbd>             | next workspace                          |
| <kbd>SUPER</kbd> + <kbd>mouse_up</kbd>               | previous workspace                      |

#### Relative workspace

| Keys                                                  | Action                            |
| :---------------------------------------------------- | :-------------------------------- |
| <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>Right</kbd> | change active workspace forwards  |
| <kbd>SUPER</kbd> + <kbd>CTRL</kbd> + <kbd>Left</kbd>  | change active workspace backwards |

#### Special workspace

| Keys                                               | Action                      |
| :------------------------------------------------- | :-------------------------- |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>S</kbd> | move to scratchpad          |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>S</kbd>   | move to scratchpad (silent) |
| <kbd>SUPER</kbd> + <kbd>S</kbd>                    | toggle scratchpad           |

#### Move window silently

| Keys                                             | Action                        |
| :----------------------------------------------- | :---------------------------- |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>1</kbd> | move to workspace 1 (silent)  |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>2</kbd> | move to workspace 2 (silent)  |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>3</kbd> | move to workspace 3 (silent)  |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>4</kbd> | move to workspace 4 (silent)  |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>5</kbd> | move to workspace 5 (silent)  |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>6</kbd> | move to workspace 6 (silent)  |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>7</kbd> | move to workspace 7 (silent)  |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>8</kbd> | move to workspace 8 (silent)  |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>9</kbd> | move to workspace 9 (silent)  |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>0</kbd> | move to workspace 10 (silent) |

### Move window to workspace

| Keys                                               | Action               |
| :------------------------------------------------- | :------------------- |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>1</kbd> | move to workspace 1  |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>2</kbd> | move to workspace 2  |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>3</kbd> | move to workspace 3  |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>4</kbd> | move to workspace 4  |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>5</kbd> | move to workspace 5  |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>6</kbd> | move to workspace 6  |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>7</kbd> | move to workspace 7  |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>8</kbd> | move to workspace 8  |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>9</kbd> | move to workspace 9  |
| <kbd>SUPER</kbd> + <kbd>SHIFT</kbd> + <kbd>0</kbd> | move to workspace 10 |

| Keys                                                                   | Action                                     |
| :--------------------------------------------------------------------- | :----------------------------------------- |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>CTRL</kbd> + <kbd>Right</kbd> | move window to next relative workspace     |
| <kbd>SUPER</kbd> + <kbd>ALT</kbd> + <kbd>CTRL</kbd> + <kbd>Left</kbd>  | move window to previous relative workspace |

## <a id="custom-keybindings"></a><img src="https://readme-typing-svg.herokuapp.com?font=Lexend+Giga&size=23&pause=1000&color=CCA9DD&width=435&lines=Custom%20Keybindings" width="450"/>

You can define your own keybindings by editing your preferences file at:

```bash
~/.config/hypr/userprefs.conf
```

For example, to create a keybinding that launches the **HyDE Game Launcher**, add the following line:

```ini
bind = $mainMod, SPACE, exec, $HOME/.local/lib/hyde/gamelauncher.sh
```

This will bind the **Game Launcher** to <kbd>SUPER</kbd> + <kbd>Space</kbd>.  
You can replace `SPACE` with any other key you prefer.

The `gamelauncher.sh` script is included by default and lives at:

```bash
~/.local/lib/hyde/gamelauncher.sh
```

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

<div align="center">

</div>
-->

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

<div align="right">
  <sub>Last edited on: 02/01/2025<span id="last-edited"></span></sub>
</div>
