Garuda Hyprland Configuration

This repository contains my complete Garuda Linux Hyprland configuration backup, including all ~/.config files, UI scaling fixes for high-DPI displays, and custom desktop files.

Keeping it Updated:

• Just run ./sync-config.sh whenever you make config changes • The script will handle everything automatically!

System Informationw

• OS: Garuda Linux (Hyprland edition)
• Display: 4K (3840x2160) @ 144Hz with 1.25x scaling
• Window Manager: Hyprland
• Status Bar: Waybar
• Terminal: Warp (with custom scaling)
• Total Config Directories: 65+ applications (cleaned of sensitive data)

Directory Structure

├── hypr/                    # Hyprland configuration (legacy)
│   ├── hyprland.conf       # Main Hyprland config
│   ├── hypridle.conf       # Idle management
│   ├── hyprstart           # Startup script
│   └── scripts/            # Custom scripts
├── dotconfig/              # Complete ~/.config backup (65+ apps)
│   ├── hypr/               # Hyprland configuration
│   ├── waybar/             # Status bar configuration
│   ├── kitty/              # Terminal emulator
│   ├── nvim/               # Neovim configuration
│   ├── warp-terminal/      # Warp terminal settings
│   ├── fish/               # Fish shell
│   ├── foot/               # Terminal emulator
│   ├── starship.toml       # Shell prompt configuration
│   ├── gtk-*/              # GTK themes and settings
│   ├── qt5ct/ & qt6ct/     # Qt theming
│   ├── mako/               # Notification daemon
│   ├── wofi/               # App launcher
│   ├── swaylock/           # Lock screen
│   ├── swaync/             # Notification center
│   ├── ranger/             # File manager
│   ├── btop/               # System monitor
│   ├── helix/              # Text editor
│   ├── mpv/                # Media player
│   ├── vlc/                # VLC media player
│   ├── alacritty/          # Terminal emulator
│   ├── geany/              # Text editor
│   ├── Thunar/             # File manager
│   ├── libreoffice/        # Office suite
│   ├── microsoft-edge-dev/ # Edge browser
│   ├── google-chrome-*/    # Chrome variants
│   ├── vivaldi-*/          # Vivaldi browser
│   ├── Windsurf/           # Code editor
│   ├── wpaperd/            # Wallpaper daemon
│   ├── systemd/            # User systemd services
│   ├── psd/                # Profile sync daemon
│   ├── garuda*/            # Garuda Linux tools
│   ├── nwg-*/              # NWG suite apps
│   ├── Kvantum/            # Qt theme engine
│   └── ... (40+ more apps)
├── desktop-files/          # Custom .desktop files with scaling fixes
│   ├── dev.warp.Warp.desktop    # Warp terminal (scaled down)
│   ├── obsidian.desktop         # Obsidian (scaled up)
│   └── ...
├── other-configs/          # Legacy config files
│   ├── .bashrc
│   ├── .zshrc
│   └── waybar/             # Waybar configuration
└── scripts/                # Custom scripts

Key Features

1. Per-Application UI Scaling

• Warp Terminal: Scaled down (1.0x) for crisp text
• Obsidian: Scaled up (1.5x) for better readability
• System Default: 1.25x scaling for 4K display

2. Hyprland Window Rules

• Custom window sizing for applications
• Floating window controls
• Workspace management

3. High-DPI Display Optimization

• 4K display support with proper scaling
• Per-application scaling controls
• Consistent UI across different app types

Installation

⚠️ IMPORTANT: This is a complete system configuration backup. DO NOT blindly copy everything to your system. Instead, selectively copy configurations you need.

🔒 SECURITY NOTE: The following sensitive data has been removed from this backup:

• API keys and tokens from VS Code history files
• 1Password configuration and data
• Environment files (.env)
• Go telemetry tokens
• Any other files containing credentials or secrets

1. Backup Current Configuration

# Create timestamped backup
cp -r ~/.config ~/.config.backup-$(date +%Y%m%d-%H%M%S)
cp -r ~/.local/share/applications ~/.local/share/applications.backup-$(date +%Y%m%d-%H%M%S)

2. Selective Configuration Restore

Option A: Restore Specific Applications

# Example: Restore only Hyprland configuration
cp -r dotconfig/hypr ~/.config/

# Example: Restore only Waybar
cp -r dotconfig/waybar ~/.config/

# Example: Restore terminal configurations
cp -r dotconfig/kitty ~/.config/
cp -r dotconfig/warp-terminal ~/.config/

Option B: Restore Everything (DANGEROUS)

# Only do this if you're sure!
cp -r dotconfig/* ~/.config/

3. Apply Custom Desktop Files

cp desktop-files/* ~/.local/share/applications/
update-desktop-database ~/.local/share/applications

4. Apply Shell Configurations

cp other-configs/.bashrc ~/
cp other-configs/.zshrc ~/

5. Reload Services

hyprctl reload
systemctl --user restart waybar

UI Scaling Guide

The Problem: Linux Doesn't Uniformly Handle App Rendering

With a 4K display at 1.25x base scaling, different applications respond differently:

• Some apps scale too large (fonts become massive)
• Some apps scale too small (UI elements are tiny)
• Each app type (GTK, Qt, Electron, native) needs individual tuning

Solution: Use custom .desktop files with per-application scaling environment variables.

Environment Variables for Scaling

Variable	App Type	Example Values	Notes
GDK_SCALE	GTK apps	0.8, 0.9, 1.0, 1.25, 1.5	GNOME apps, many Linux GUI apps
QT_SCALE_FACTOR	Qt apps	0.8, 0.9, 1.0, 1.25, 1.5	KDE apps, Qt-based applications
--force-device-scale-factor	Electron apps	0.8, 0.9, 1.0, 1.25, 1.5	VS Code, Discord, Obsidian, Slack
ELECTRON_SCALE	Electron apps	0.8, 0.9, 1.0, 1.25, 1.5	Alternative Electron variable

Creating Custom Per-App Scaling

Step 1: Find the Original Desktop File

# Search for the app's desktop file
find /usr/share/applications -name "*appname*.desktop"
# Or list all
ls /usr/share/applications/

Step 2: Copy to Local Applications

# Copy to this repo's desktop-files directory
cp /usr/share/applications/myapp.desktop ~/code/garuda-hyprland-config/desktop-files/

# Or copy directly to local (not recommended - use repo as master)
cp /usr/share/applications/myapp.desktop ~/.local/share/applications/

Step 3: Edit the Exec Line

For GTK/Qt apps:

[Desktop Entry]
Name=MyApp
# Original line:
# Exec=myapp %U
# Modified line with scaling:
Exec=env GDK_SCALE=0.9 QT_SCALE_FACTOR=0.9 myapp %U

For Electron apps:

[Desktop Entry]
Name=MyElectronApp
# Original line:
# Exec=/usr/bin/myapp %U
# Modified line with scaling:
Exec=env GDK_SCALE=1.5 QT_SCALE_FACTOR=1.5 /usr/bin/myapp --force-device-scale-factor=1.5 %U

For apps needing smaller fonts (like Warp):

[Desktop Entry]
Name=Warp
Exec=env GDK_SCALE=0.9 QT_SCALE_FACTOR=0.9 warp-terminal --force-device-scale-factor=0.9 %U

Step 4: Link from Repo and Update Database

# Create symlink from repo to system
ln -sf ~/code/garuda-hyprland-config/desktop-files/myapp.desktop ~/.local/share/applications/

# Update desktop database
update-desktop-database ~/.local/share/applications

Step 5: Test the Application

# Launch from application menu or command line
gtk-launch myapp

Real-World Examples from This Config

Warp Terminal (scaled down to 0.9x):

Exec=env GDK_SCALE=0.9 QT_SCALE_FACTOR=0.9 warp-terminal --force-device-scale-factor=0.9 %U

Why: Warp's default fonts are too large on 4K displays

Obsidian (scaled up to 1.5x):

Exec=env GDK_SCALE=1.5 QT_SCALE_FACTOR=1.5 ELECTRON_SCALE=1.5 /usr/bin/obsidian --force-device-scale-factor=1.5 %U

Why: Obsidian needs larger UI for comfortable reading/writing

Common Scaling Values

Scale	Use Case
0.8x	Apps with very large default UI
0.9x	Apps with slightly large UI (like Warp)
1.0x	Apps that render perfectly at base scaling
1.25x	Match system default (our monitor setting)
1.5x	Apps needing larger UI (reading/writing apps)
2.0x	Apps with very small default UI

Troubleshooting

UI Too Small

• Increase scaling values in desktop files
• Common values: 1.25, 1.5, 1.75, 2.0

UI Too Large

• Decrease scaling values in desktop files
• Use values like 0.8, 1.0

Window Sizing Issues

• Check Hyprland window rules in hypr/hyprland.conf
• Ensure floating windows have proper size rules

Monitor Configuration

Current monitor setup:

monitor = eDP-2, 3840x2160@144.00101, 0x0, 1.25

Keybindings

See hypr/hyprland.conf for complete keybinding list.

Key shortcuts:

• Super + Return: Kitty terminal
• Super + T: Fullscreen Kitty
• Super + F1: Firefox
• Super + Shift + R: Reload Hyprland

Sync Script

The sync-config.sh script automates the process of updating this repository with your current configuration:

# Run the sync script
./sync-config.sh

# Then commit the changes
git add .
git commit -m "Update configuration $(date +%Y-%m-%d)"
git push

What the sync script does:

• ✅ Copies all important configuration directories
• ✅ Automatically removes sensitive data (API keys, passwords, etc.)
• ✅ Updates desktop files with scaling fixes
• ✅ Updates README with current directory count
• ✅ Provides colored output and progress feedback
• ✅ Handles missing directories gracefully

Sensitive data automatically removed:

• Environment files (.env)
• API keys and tokens
• Browser local storage and session data
• 1Password data
• VS Code history files
• Credentials and secrets

Credits

• Garuda Linux team for the base configuration
• Hyprland community for window management
• Various scaling solutions adapted for high-DPI displays