KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

ViperDots-Hyprland

★ 29 Open GitHub ↗

A repository for my Hyprland dotfiles.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# My Hyprland Setup

This repository contains my personal configuration files for Hyprland. I've aimed for a clean, minimalistic setup, perfect for those who appreciate efficiency and a distraction-free workspace. Plus, I’m using **GNU Stow** to keep everything tidy with symlinks. The config files have also been separated into discrete parts for better management.

## Table of Contents

- [Installation](#installation)
- [Usage](#usage)
- [Screenshots](#screenshots)
- [Customization](#customization)
- [Contributing](#contributing)
- [Acknowledgement](#acknowledgement)
- [License](#license)

## Installation

Note: Install [HyDE](https://github.com/HyDE-Project/HyDE) first as this project uses that as a base else many things will not work. Check all scripts that are to be executed for your personal safety. I am not responsible for any form of data loss or use of weapons of mass destruction on your personal computer or your home.

1. **Clone the repository:**
   ```bash
   git clone https://github.com/Beast-Viper/ViperDots-Hyprland.git ~/ViperDots-Hyprland

2. **Navigate to the dotfiles directory:**
   ```bash
   cd ~/ViperDots-Hyprland

3. **Install Dependencies (Choose ONE method):**

This step installs all the necessary programs.  Pick the method that suits your distro:

a) **AUR Helper (paru or yay - Arch Linux):**

```bash
     paru -S avizo btop blueman bluez bluez-utils brightnessctl conky easyeffects fastfetch fish hyprland hyprlock hypridle hyprsunset kitty nautilus network-manager-applet nvim nwglook pactl pavucontrol qt5ct qt6ct swaync swww waybar wlogout
     ```

b) **pacman (Arch Linux):**

```bash
     sudo pacman -S avizo btop blueman bluez bluez-utils brightnessctl conky easyeffects fastfetch fish hyprland hyprlock hypridle hyprsunset kitty nautilus network-manager-applet nwglook nvim pactl pavucontrol qt5ct qt6ct swaync swww waybar wlogout
     ```

c) **Your Distribution's Package Manager:**
     Adapt the commands above to your package manager (apt, dnf, zypper, etc.).  You'll need to find the correct package names for your distro.

4. **Run the install script:**
   
   IMPORTANT: Make sure you are not logged into Hyprland before running the script else script will fail.

```bash
   chmod +x install.sh          #Make it executable

./install.sh                 #Run the script

## Usage
  Any display manager (except perhaps GDM) will work but only tested with plasma-login-manager.

Super + / should show all keybinds but is currently broken due to lua migration.

The dotfiles are public property. Do whatever you wish to do and make it yours!

https://github.com/HyDE-Project/HyDE was used as the base but everything has been customized to my liking.

## Screenshots

Here are some screenshots of my setup:

Desktop w/ hyprpanel:
<img width="1920" height="1080" alt="image" src="https://github.com/user-attachments/assets/1193a167-b6dc-442f-bd95-8687edab0140" />

Browser (Zen Browser w/ Catppuccin Mocha colours):
<img width="1920" height="1080" alt="image" src="https://github.com/user-attachments/assets/b0df6373-7b21-4e29-b35b-3105175bb005" />

Others:
<img width="1920" height="1080" alt="image" src="https://github.com/user-attachments/assets/2a0b8d25-8f77-42df-ab2f-ed9bb96cb31c" />
<img width="1920" height="1080" alt="image" src="https://github.com/user-attachments/assets/f0c2dd8e-bbd3-4436-92a5-cc19d9b19ca9" />

## Customization

~/.config/hypr contains most hyprland configs such as hyprland.lua, hypridle.lua, hyprlock.conf and many more.

You can also find separate files for individual things such as animations, keybinds and others.

GTK3/4 theme is a personal catppuccin-like modified version using https://github.com/vinceliuice/WhiteSur-gtk-theme as base.

## Contributing

Contributions are welcome! If you find any bugs or have suggestions for improvements, please open an issue or submit a pull request.

## Acknowledgement

Most wallpapers provided are made by Arseniy Chebynkin and his collegue.
Artstation link: https://www.artstation.com/arsenixc
Current wallpaper in screenshot is of Wuthering Waves by Kuro Games.

## License

This project is licensed under the MIT License. Feel free to use, modify, and distribute it as you wish! Just make sure to include the original license in any copies or substantial portions of the software.

For more details, check out the [LICENSE](LICENSE) file in this repository.

ViperDots-Hyprland

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README