Welcome to...

Tranquil's Hyprland Dot Files

Table of Contents

Category	Description
How does it look?	Images of the actual rice
Installation	Directions to clone and use this repository
How does the install script work?	Explanation of the install script
Features	Included features
Bindings	Keybindings list
Used Packages	All packages used

How does it look?

Desktop	Launcher

Wallpaper Selector	Notification Manager

Lock Manager	Settings

Color Examples

Minecraft Purple	Anord Pink	Cat Club Green

Note

All wallpaper colors are completely adaptive! It changes everything, all just depends on what wallpaper you are using.

Installation

1. Execute the curl entrypoint with curl:

   bash <(curl -sL https://raw.githubusercontent.com/Tranquil-M/dots/refs/heads/master/scripts/curl-entrypoint.sh)

Important

The install script is currently only compatible with Arch Linux.

How does the install script work?

Curl Entrypoint

1. Verifies dependencies and operating system.
2. Installs git if not present.
3. Asks user if they want to clone using HTTPS or SSH
4. Executes the dotfiles installer

Dotfiles installer

1. Verifies dependencies, operation system, and internet connection.
2. Installs all the neccessary packages from packages.txt in the project root.
3. Asks the user if they want to install am SDDM theme. This will clone Darkkal44's qylock and run the corresponding installation script.
4. Sets default file manager, browser, etc.
5. Overwrites the current configuration in place with the new one, all synced with GNU stow.
6. Runs post-installation script such as persistent workspace creation.

Note

The curl entry point is completely optional, and serves as a wrapper for ease of use.

Features

These dotfiles are meant to be simple and practical for daily use, with some additional features:

• Screenshot utility using Grim, Slurp, and Satty
  Saves to: ~/Pictures/Screenshots
• Noctalia
  • Wallpaper switcher
  • Application Launcher
  • Lockscreen
  • Logout Menu
  • Clipboard History
  • Tab switcher
  • Control Panel
  • On-screen display
• Custom Discord theme using Equibop (Discord Client)
• Kickstart Nvim configuration
• Exa
• Zoxide
• Firefox theme using pywal-fox and custom css
• Qylock customizable sddm themes

Keybindings

Core actions

• Super + Space → Open launcher
• Super + C → Open control center
• Super + S → Open settings
• Super + M → Open media panel
• Super + N → Open notification history
• Super + X → Open emoji selector via launcher
• Super + V → Open clipboard history via launcher
• Super + B → Open battery panel
• Alt + Tab → Tab Switcher

System

• Super + A → Toggle Bar Visibility

Applications

• Super + Enter → Open terminal
• Super + Shift + F → Open file manager
• Super + E → Toggle wallpaper

Media controls

• Volume up key → Increase volume
• Volume down key → Decrease volume
• Mute key → Mute audio
• Brightness up key → Increase brightness
• Brightness down key → Decrease brightness
• Next track → Next song
• Play/Pause → Play or pause media
• Previous track → Previous song

Screenshots

• Super + Z → Capture selected area
• Super + Shift + Z → Capture full screen

Window management

• Super + W → Close active window
• Super + T → Toggle floating window
• Super + Backspace → Open session menu
• Super + F → Fullscreen mode
• Super + Alt + F → Exit fullscreen mode

Notifications

• Super + Comma → Remove oldest notification
• Super + Shift + Comma → Clear all notifications

Focus navigation

• Super + Arrow keys → Move focus between windows

Move windows

• Super + Shift + Arrow keys → Move window in direction

Workspaces

• Super + 1–0 → Switch to workspace 1–10
• Super + Shift + 1–0 → Move window to workspace 1–10
• Super + Mouse wheel → Switch workspaces

Mouse actions

• Super + Left click drag → Move window
• Super + Right click drag → Resize window

Window switching

• Alt + Tab → Next window
• Alt + Shift + Tab → Previous window

Laptop

• Close lid → Lock screen and suspend system

Note

Temporary workspaces are supported, but a minimum of 3 persistent workspaces are assigned per-monitor on startup.

Packages

• Btop
• GNU Stow
• Equibop
• Exa
• Grim
• Kickstart
• Kitty
• Little Fox
• Matugen Templates
• Pywal-Fox
• Satty
• Qylock
• Slurp
• Zoxide
• Noctalia