Files

s0wlz (Matthias Puchstein) 8018b53353 feat: finalize migration to chezmoi and modernize configuration logic

- Modularize Hyprland config into hyprland.d/
- Implement infinitely scalable monitor/workspace logic using templates and loop-based data structures
- Consolidate host-specific configs (hyprlock, hyprpaper, waybar) into single templates
- Resolve waybar symlink conflict and fix template execution errors
- Integrate chezmoi data variables for scale, resolution, and peripherals

2025-12-27 22:52:43 +01:00

3.4 KiB

Raw Blame History

Project Overview

This is a chezmoi source directory used for managing user configuration files (dotfiles) on a Linux system. It centralizes the configuration for the shell, window manager, editor, and other utilities, allowing for consistent setups across multiple machines (referenced by hostname tags like owlenlap01, owlenpc00).

Key Components

Dotfile Manager: chezmoi
Window Manager: Hyprland (Modular configuration)
Shell: Zsh managed with Zim and themed with Powerlevel10k.
Editor: Neovim configured with Lua and lazy.nvim.
Status Bar: Waybar
Terminal Emulators: Kitty, Alacritty
Other: Tmux, Mpv, Dunst/SwayNC, Fuzzel/Rofi equivalent.

Directory Structure

The directory structure follows standard chezmoi conventions:

dot_config/: Maps to ~/.config/. Contains the bulk of application configurations.
- hypr/: Hyprland configuration. hyprland.conf is the entry point, sourcing files from hyprland.d/. Host-specific overrides exist (e.g., hyprpaper.conf##hostname.owlenlap01).
- nvim/: Neovim configuration. init.lua bootstraps lazy.nvim.
- zsh/: Zsh configuration, including dot_zshrc (mapped to ~/.config/zsh/.zshrc).
- waybar/: Waybar configuration and styles.
dot_local/: Maps to ~/.local/. Contains scripts and local data.
.chezmoiscripts/: Contains scripts that run when chezmoi apply is executed (e.g., run_onchange_...).
dot_profile.tmpl: A template that renders to ~/.profile, handling environment variables. It uses tags (e.g., dev, desktop) to conditionally include configurations.

Usage

This directory is the source of truth. Do not edit files directly in ~/.config if they are managed here; your changes will be overwritten.

Common Commands

Apply Changes:
```
chezmoi apply
```
Renders templates and copies files to the target destination (usually $HOME).
Preview Changes:
```
chezmoi diff
```
Shows what will change in the destination directory if chezmoi apply is run.
Edit a File:
```
chezmoi edit <file_path>
```
Opens the source file for editing in your $EDITOR.
Check Status:
```
chezmoi status
```

Templates and Logic

Files ending in .tmpl are Go templates. They support logic based on chezmoi data.

Variables: {{ .chezmoi.homeDir }} represents the user's home directory.
Tags: Logic like {{- if (index $tags "dev") }} is used to enable features based on the machine's role (e.g., development tools, desktop-specific GPU settings).

Development Conventions

Hyprland: Keep configuration modular. Add new settings to the appropriate file in dot_config/hypr/hyprland.d/ rather than cluttering hyprland.conf.
Neovim: Configuration is split into lazy_setup.lua (plugins) and polish.lua (general settings).
Zsh: Custom aliases should go in dot_config/zsh/aliases.zsh.
Naming: Use dot_ to represent a dot prefix (e.g., dot_config -> .config). Use executable_ to mark files as executable.

3.4 KiB Raw Blame History