mirror of
https://github.com/duma799/hyprduma-config.git
synced 2026-05-13 22:21:00 +00:00
duma97
256 lines
6.7 KiB
Markdown
256 lines
6.7 KiB
Markdown
# HyprDuma Dotfiles
|
|
|
|
Personal Hyprland configuration focused on productivity and ergonomics.
|
|
|
|
## Features
|
|
|
|
### Enhanced Keybindings
|
|
- **[KEYBINDS.md](KEYBINDS.md)** - Complete keybindings reference
|
|
|
|
### Visual & UX
|
|
- Minimal gaps (10px/40px) for space efficiency
|
|
- Blur effects and transparency
|
|
- Smooth custom animations with bezier curves
|
|
- **Pywal integration** - Dynamic colors from wallpaper (optional)
|
|
|
|
### Input
|
|
- 3-finger gestures (horizontal: workspace, vertical: fullscreen)
|
|
- Dual keyboard layout (US/RU with `ALT + SHIFT` toggle)
|
|
- Numlock enabled by default
|
|
- Optimized touchpad scrolling
|
|
|
|
### Display Setup
|
|
- Dual monitor configuration (HDMI-A-1 flipped + eDP-1)
|
|
- Workspaces 1-4 on external monitor
|
|
- Workspaces 5-10 on laptop screen
|
|
|
|
---
|
|
|
|
## Complete Installation Guide
|
|
|
|
Follow these steps in order to install the complete setup from scratch.
|
|
|
|
### Prerequisites: Install AUR Helpers (Optional but Recommended)
|
|
|
|
If you don't have yay and paru installed yet, you can install both:
|
|
|
|
```bash
|
|
# Install yay
|
|
sudo pacman -S --needed git base-devel
|
|
git clone https://aur.archlinux.org/yay.git
|
|
cd yay
|
|
makepkg -si
|
|
cd .. && rm -rf yay
|
|
|
|
# Install paru
|
|
git clone https://aur.archlinux.org/paru.git
|
|
cd paru
|
|
makepkg -si
|
|
cd .. && rm -rf paru
|
|
```
|
|
|
|
### Step 1: Install Required Packages
|
|
|
|
```bash
|
|
# Install all required packages in one command
|
|
sudo pacman -S hyprland hyprlock hyprshot wlogout kitty waybar swaybg waypaper wofi nautilus wireplumber pipewire-pulse brightnessctl playerctl adwaita-cursors python-pywal
|
|
```
|
|
|
|
### Step 2: Install Caelestia Shell (Recommended)
|
|
|
|
Caelestia is a modern shell with AI features that integrates with the pywal theming system.
|
|
|
|
```bash
|
|
# Install Caelestia via yay
|
|
yay -S caelestia-shell # caelestia-shell-git is bleeding edge & unstable one
|
|
|
|
# Start Caelestia daemon (it will auto-restart when pywal colors change)
|
|
caelestia shell -d &
|
|
```
|
|
|
|
**Note:** Caelestia runs as a background service and integrates with pywal for dynamic color theming.
|
|
|
|
### Step 3: Clone This Repository
|
|
|
|
```bash
|
|
# Clone to a temporary location
|
|
cd ~/Downloads
|
|
git clone https://github.com/duma97/hyprduma-config.git
|
|
cd hyprduma-config
|
|
```
|
|
|
|
### Step 4: Backup Existing Configs (If Any)
|
|
|
|
```bash
|
|
# Backup existing Hyprland config
|
|
[ -d ~/.config/hypr ] && mv ~/.config/hypr ~/.config/hypr.backup
|
|
|
|
# Backup existing waybar config
|
|
[ -d ~/.config/waybar ] && mv ~/.config/waybar ~/.config/waybar.backup
|
|
|
|
# Backup existing wlogout config
|
|
[ -d ~/.config/wlogout ] && mv ~/.config/wlogout ~/.config/wlogout.backup
|
|
```
|
|
|
|
### Step 5: Install Hyprland Configuration
|
|
|
|
```bash
|
|
# Create Hypr config directory
|
|
mkdir -p ~/.config/hypr
|
|
|
|
# Copy main config
|
|
cp hyprland.conf ~/.config/hypr/
|
|
cp hyprland-colors.conf ~/.config/hypr/
|
|
|
|
# Create screenshots directory (used by config)
|
|
mkdir -p ~/Pictures/Screenshots
|
|
```
|
|
|
|
### Step 6: Configure Your Applications
|
|
|
|
**IMPORTANT:** Edit the config file to set your preferred applications.
|
|
|
|
```bash
|
|
# Open the config file
|
|
nvim ~/.config/hypr/hyprland.conf
|
|
|
|
# Find lines 27-34 and adjust these variables:
|
|
# $terminal = kitty # Your terminal
|
|
# $fileManager = dolphin # Your file manager
|
|
# $menu = wofi --show drun # Your app launcher
|
|
# $telegram = Telegram # Path to Telegram
|
|
# $spotify = spotify # Path to Spotify
|
|
# $vscode = code # Path to VSCode
|
|
# $browser = your-browser # Your browser command
|
|
```
|
|
|
|
### Step 7: Install Pywal Integration (Strongly Recommended)
|
|
|
|
Pywal provides dynamic color theming based on your wallpaper.
|
|
|
|
```bash
|
|
# Install pywal templates
|
|
mkdir -p ~/.config/wal/templates
|
|
cp -r wal/templates/* ~/.config/wal/templates/
|
|
|
|
# Copy the color application and wallpaper sync scripts
|
|
cp pywal.sh ~/.config/hypr/
|
|
cp sync-caelestia-wallpaper.sh ~/.config/hypr/
|
|
chmod +x ~/.config/hypr/pywal.sh
|
|
chmod +x ~/.config/hypr/sync-caelestia-wallpaper.sh
|
|
|
|
# Also copy to home directory for easier access
|
|
cp pywal.sh ~/pywal.sh
|
|
chmod +x ~/pywal.sh
|
|
|
|
# Test pywal with a wallpaper
|
|
wal -i /path/to/your/wallpaper.png
|
|
|
|
# Apply colors to Hyprland and Caelestia (from anywhere)
|
|
~/pywal.sh
|
|
```
|
|
|
|
**What this does:**
|
|
- Generates a color scheme from your wallpaper
|
|
- Applies colors to Hyprland window borders
|
|
- Applies colors to Caelestia shell (if installed)
|
|
- Restarts necessary services to apply changes
|
|
|
|
### Step 8: Start Hyprland
|
|
|
|
```bash
|
|
# If you're in a TTY, start Hyprland
|
|
Hyprland
|
|
|
|
# If already in Hyprland, reload the config
|
|
# Press SUPER + SHIFT + R (or restart Hyprland session)
|
|
```
|
|
|
|
---
|
|
|
|
## Post-Installation
|
|
|
|
### Setting Wallpaper with Pywal
|
|
|
|
```bash
|
|
# Generate colors and apply them
|
|
wal -i /path/to/wallpaper.png && ~/pywal.sh
|
|
|
|
# Or use the wallpapers included in this repo
|
|
wal -i ~/.config/hypr/wallpapers/sakura.jpg && ~/pywal.sh
|
|
```
|
|
|
|
**Note about waypaper and Caelestia:**
|
|
- This config uses **swaybg** as the wallpaper backend (not hyprpaper)
|
|
- Use `waypaper` GUI (Super+W) to select wallpapers
|
|
- Waypaper with swaybg backend automatically saves and restores your wallpaper on login
|
|
- **Important**: Caelestia shell has its own wallpaper management that may conflict with waypaper
|
|
- The config includes `sync-caelestia-wallpaper.sh` to automatically sync Caelestia's wallpaper reference with swaybg
|
|
- This sync happens automatically on startup and when you open waypaper (Super+W)
|
|
- For pywal integration, use `wal -i` as shown above, then run the apply script (which also syncs Caelestia)
|
|
|
|
### Monitor Configuration
|
|
|
|
If you have different monitors, adjust lines 4-18 in `~/.config/hypr/hyprland.conf`:
|
|
|
|
```bash
|
|
nvim ~/.config/hypr/hyprland.conf
|
|
|
|
# Edit monitor configuration:
|
|
# monitor = eDP-1, 1920x1080@144, 1920x0, 1
|
|
# monitor = HDMI-A-1, 1920x1080@144, 0x0, 1, transform, 2
|
|
```
|
|
|
|
### Keyboard Layout
|
|
|
|
Default is US/RU with ALT+SHIFT toggle. To change, edit `~/.config/hypr/hyprland.conf` line 42:
|
|
|
|
```
|
|
kb_layout = us, ru # Change to your layouts
|
|
```
|
|
|
|
---
|
|
|
|
## Documentation
|
|
|
|
- **[KEYBINDS.md](KEYBINDS.md)** - Complete keybindings reference
|
|
- **[PYWAL-SETUP.md](PYWAL-SETUP.md)** - Detailed pywal integration guide
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### Hyprland won't start
|
|
- Check if all required packages are installed
|
|
- Review error logs: `journalctl -b | grep hyprland`
|
|
|
|
### Applications don't launch
|
|
- Make sure you edited the app variables in `hyprland.conf` (lines 27-34)
|
|
- Check if the applications are actually installed
|
|
|
|
### Pywal colors not applying
|
|
- Ensure the script is executable: `chmod +x ~/pywal.sh`
|
|
- Check if pywal cache exists: `ls ~/.cache/wal/`
|
|
- Manually reload: `~/pywal.sh`
|
|
|
|
### Caelestia colors not updating
|
|
```bash
|
|
# Restart Caelestia daemon
|
|
pkill caelestia && sleep 0.5 && caelestia shell -d &
|
|
```
|
|
|
|
### Wallpaper not showing on startup
|
|
```bash
|
|
# Restore wallpaper with waypaper
|
|
waypaper restore
|
|
|
|
# Manually restart swaybg if needed
|
|
pkill swaybg && swaybg &
|
|
```
|
|
|
|
---
|
|
|
|
## Note
|
|
|
|
Everything is still in progress. Feel free to customize and adjust to your needs!
|