Skip to content
43PRPublic

About

Hyprland + Quickshell Setup for Arch-based distributions

Topics

Resources

Stars

2.0k stars

Watchers

21 watching

Forks

Repository files navigation

1793227457

English · Español · Русский · 中文 · 日本語 · Português · Français · Deutsch

✧ What is this? Requirements?

A full customizable Linux desktop: bar, system settings and menus to customize your desktop. Built on Hyprland (window manager) and Quickshell (what the bar and menus are made with).

This setup aims to keep things simple, fast, practical, and easy to make your own without editing config files.

Requirements

  • Arch-based distro: Arch, CachyOS, EndeavourOS, Manjaro, etc.
  • A mostly clean install. Replaced configs are backed up automatically.

New to Linux? I recommend watching this CachyOS Tutorial.

Need help? Join the Discord (button above).

Hardware

  • RAM: 4 GB minimum, 8 GB recommended.
  • GPU: Intel, AMD or NVIDIA with compatible wayland drivers.
  • Display: Will look much better in FHD or higher.

As reference I made this project with a i5 6th dell laptop with integrated graphics so it should be really smooth in other potatoes too.

Features

  • Quickshell — Fast, lightweight, customizable desktop components.
  • Top bar - Customizable bar with settings, and quick shortcuts.
  • Settings — System settings, customize hyprland appearance, and themes.
  • Wallpaper picker — Customizable | Wallpaper-based color generation, and live wallpapers.
  • Preset Themes — Monochrome, Nord, Tokyo Night and more, with custom theme support.
  • App Launcher — Rofi App search, clipboard history, and opacity controls.
  • Zsh + Starship — Enhanced shell with autosuggestions and command history.

Keybinds

Hover over elements to see actions.

Keybind Action
Super + T Terminal
Super + Q Close active window
Super + D Application launcher
Super + Space Toggle floating window
Super + F Toggle fullscreen
Super + 1, 2, 3.. Change workspaces
Super + Shift + 1, 2.. Move window to workspace
Super + E File manager
Super + B Browser
Super + V Clipboard history
Super + I Settings menu
Super + Grave Logout menu
Super + S Side panel
Super + O Switch opacity
Super + C Notes & Reminders
Super + W Wallpaper selector
Super + Shift + C Color picker tool
Super + Mouse wheel Zoom in/out
Super + Shift + W Toggle bar
Super + Tab Lock screen
Super + R Toggle screen recorder
SHIFT + F12 Text extractor (OCR)

Note

Move and resize windows with Super + left/right mouse drag.

All keybinds: .config/hypr/keybinds.lua


Installation

READ ALL

Works for Arch, CachyOS, EndeavourOS, Manjaro, etc.

This is mainly intended for a clean installation (existing configuration files that are being replaced will be backed up automatically).

First install git then use the next command and continue the installation until it's finished

sudo pacman -S git   
git clone https://github.com/43PR/dotfiles.git
cd dotfiles
chmod +x install.sh
./install.sh

After the installation finishes log out and back in.

Check settings and keybinds first.

Right-click on desktop components to customize them.

To close components use Esc key or use the same keybind.

Important

Do not move or delete the dotfiles repository after installation.

This setup uses symbolic links (symlinks) that point to files inside the cloned repository. If you move or delete the repository, those symlinks will break.

If you relocate the repository, simply run:

./install.sh

The installer will update the existing symlinks to point to the new location.


Credits

Wallpaper selector: modified, originally built from the hyprquickpaper by iamsurjog.

Banner artwork: by cherry✟ (@aletiune).

About

Hyprland + Quickshell Setup for Arch-based distributions

Topics

Resources

Stars

2.0k stars

Watchers

21 watching

Forks

Releases

Packages

Contributors

Languages