[ Quickshell/II ]

Premium Material 3 / Material You dotfiles for Hyprland, powered by Quickshell.

System Preview

Overview

This repository is a heavily customized fork of ii-vynx, which itself is based on illogical-impulse. This is my personal customization. It's not focused on performance or stability — if you use it, expect a lot of bugs. If you find one, please open an issue or report it in the ii-p3drovfx thread inside end-4 discord. I also accept PRs.

It aims to provide a state-of-the-art Linux desktop experience by strictly adhering to Material 3 (Material You) design principles, featuring dynamic theming via Matugen and a highly modular architecture built on Quickshell.

Note

This repository is a work in progress. Some modules, like the Gmail client, require manual setup of API keys.

Requirements

• Hyprland 0.56.1 or newer
• Matugen 4.1.0 or newer
• quickshell-git 0.3.0 or newer

Installation

Default installation

Use this if you don't have illogical-impulse already installed. It sets up the base dotfiles and everything they need, then puts my config on top.

git clone --recurse-submodules https://github.com/P3DROVFX/ii-p3drovfx.git
cd ii-p3drovfx
./setup-ii-p3drovfx.sh install

Minimal installation (only quickshell config)

Use this if illogical-impulse is already working and you only want my Quickshell config. Nothing else is touched, and your current config is moved to a backup rather than deleted.

git clone --recurse-submodules https://github.com/P3DROVFX/ii-p3drovfx.git
cd ii-p3drovfx
./setup-ii-p3drovfx.sh

Documentation

Please refer to the ii-p3drovfx wiki for detailed component descriptions.

🛠 Common Issues

Dynamic colors / Matugen are not working

If wallpaper colors are not being applied and you see an error such as:

matugen exited with an error, so the shell kept its previous palette.

First, make sure you are running:

• Matugen 4.1.0 or newer
• quickshell-git 0.3.0 or newer

You can check the installed versions with:

matugen --version
quickshell --version

Arch Linux / CachyOS

Make sure you are using the AUR quickshell-git package, rather than another Quickshell build provided by a third-party repository.

A reported case on CachyOS was caused by the system using the Noctalia Quickshell package from the CachyOS repositories instead of aur/quickshell-git. Replacing it with the AUR package fixed Matugen and dynamic colors.

yay -S aur/quickshell-git

If another Quickshell package is installed, your package manager may ask to replace the conflicting package.

---

Quickshell stopped working after a Qt update

Quickshell may stop starting correctly after a Qt update if the installed quickshell-git package was compiled against the previous Qt version.

For example, this can happen after updates such as:

Qt 6.11.1 -> Qt 6.11.2

Rebuild quickshell-git against the newly installed Qt libraries:

yay -S --rebuild aur/quickshell-git

Then restart Quickshell.

If rebuilding does not solve the problem, completely reinstall quickshell-git using your AUR helper.

💡 Tip

If the shell suddenly stops working immediately after a Qt system update, rebuilding quickshell-git should be one of the first troubleshooting steps.

---

Tray icons disappear after an update or shell restart

Apps such as Discord, Vesktop, Steam or other Electron apps may vanish from the system tray after the shell restarts (for example after an update) and only come back once you restart each app.

This is handled by the sni_watcher helper, which keeps the tray alive across shell restarts:

~/.config/quickshell/ii/scripts/tray/sni_watcher

It ships as source only, so it has to be built once (needs a Rust toolchain):

~/.config/quickshell/ii/scripts/rust-helpers.sh build sni_watcher

Hyprland starts it automatically at login. To start it right away without logging out:

~/.config/quickshell/ii/scripts/tray/sni_watcher & disown

You can check that it is running with pgrep -x sni_watcher. Apps whose icon is already gone need to be restarted once; after that, their icons survive shell restarts.

Credits

• end-4: Creator of illogical-impulse.
• vaguesyntax: Creator of ii-vynx.
• pc-trade: Some design and features inspo.
• so-do-i-look-like-him: Installation bug fixes.
• asteriau: Cheatsheet keybinds animations.
• hnpf: Nothing widgets design
• gowall: Dynamic icons theme system.
• hyprmon: Monitor management in settings.
• Quickshell: Widget system.
• Hyprland: Compositor.

---

If you like this project, consider giving it a star! ⭐