1
0
mirror of https://github.com/AvengeMedia/DankMaterialShell.git synced 2026-01-24 21:42:51 -05:00

Update ReadMe w/Hyprland

This commit is contained in:
purian23
2025-08-20 22:35:03 -04:00
parent e3ba365d39
commit 308a972fbd
2 changed files with 86 additions and 5 deletions

View File

@@ -9,7 +9,7 @@
</div>
A modern Wayland desktop shell built with [Quickshell](https://quickshell.org/) and designed specifically for the [niri](https://github.com/YaLTeR/niri) compositor. Features Material 3 design principles with a heavy focus on functionality and customizability.
A modern Wayland desktop shell built with [Quickshell](https://quickshell.org/) and designed for the [niri](https://github.com/YaLTeR/niri) and [Hyprland](https://hyprland.org/) compositors. Features Material 3 design principles with a heavy focus on functionality and customizability.
## Screenshots
@@ -102,9 +102,39 @@ https://github.com/user-attachments/assets/5ad934bb-e7aa-4c04-8d40-149181bd2d29
## Installation
### Compositor Setup
DankMaterialShell supports both **niri** and **Hyprland** compositors:
**Niri**:
```bash
# Arch Linux
paru -S niri-git
# Fedora
sudo dnf copr enable alebastr/niri && sudo dnf install niri
```
**Hyprland**:
```bash
# Arch Linux
sudo pacman -S hyprland
# Or from AUR for latest
paru -S hyprland-git
# Fedora
sudo dnf install hyprland
# Or use Copr for latest builds
sudo dnf copr enable solopasha/hyprland && sudo dnf install hyprland
```
For detailed Hyprland installation instructions, see the [Hyprland wiki](https://wiki.hypr.land/Getting-Started/Installation/).
### Quick Start
\*If you do not already have niri, see [#]
\*If you do not already have niri or Hyprland, see the Compositor Setup section below
**Dependencies:**
@@ -289,6 +319,47 @@ binds {
}
```
### Hyprland Integration
Add to your Hyprland config (`~/.config/hypr/hyprland.conf`):
```bash
# Required for clipboard history integration
exec-once = bash -c "wl-paste --watch cliphist store &"
# Recommended (must install polkit-mate beforehand) for elevation prompts
exec-once = /usr/lib/mate-polkit/polkit-mate-authentication-agent-1
# This may be a different path on different distributions, the above is for the arch linux mate-polkit package
# Starts DankShell
exec-once = qs -c DankMaterialShell
# Dank keybinds
# 1. These should not be in conflict with any pre-existing keybindings
# 2. You need to merge them with your existing config if you want to use these
# 3. You can change the keys to whatever you want, if you prefer something different
# 4. For the increment/decrement ones you can change the steps to whatever you like too
# Application and system controls
bind = SUPER, Space, exec, qs -c DankMaterialShell ipc call spotlight toggle
bind = SUPER, V, exec, qs -c DankMaterialShell ipc call clipboard toggle
bind = SUPER, M, exec, qs -c DankMaterialShell ipc call processlist toggle
bind = SUPER, N, exec, qs -c DankMaterialShell ipc call notifications toggle
bind = SUPER, comma, exec, qs -c DankMaterialShell ipc call settings toggle
bind = SUPERALT, L, exec, qs -c DankMaterialShell ipc call lock lock
# Audio controls (function keys)
bindl = , XF86AudioRaiseVolume, exec, qs -c DankMaterialShell ipc call audio increment 3
bindl = , XF86AudioLowerVolume, exec, qs -c DankMaterialShell ipc call audio decrement 3
bindl = , XF86AudioMute, exec, qs -c DankMaterialShell ipc call audio mute
bindl = , XF86AudioMicMute, exec, qs -c DankMaterialShell ipc call audio micmute
# Brightness controls (function keys)
bindl = , XF86MonBrightnessUp, exec, qs -c DankMaterialShell ipc call brightness increment 5 ""
# You can override the default device for e.g. keyboards by adding the device name to the last param
bindl = , XF86MonBrightnessDown, exec, qs -c DankMaterialShell ipc call brightness decrement 5 ""
```
### IPC Commands
Control everything from the command line, or via keybinds. For comprehensive documentation of all available IPC commands, see [docs/IPC.md](docs/IPC.md).
@@ -318,6 +389,12 @@ qs -c DankMaterialShell ipc call mpris next
## Theming
### Custom Themes
DankMaterialShell supports custom color themes! You can create your own Material Design 3 color schemes or use pre-made themes like Cyberpunk Electric, Hotline Miami, and Miami Vice.
For detailed instructions on creating and using custom themes, see [docs/CUSTOM_THEMES.md](docs/CUSTOM_THEMES.md).
### System App Integration
There's two toggles in the appearance section of settings, for GTK and QT apps.