124 lines
5.2 KiB
Markdown
124 lines
5.2 KiB
Markdown
# dotfiles
|
|
|
|
Personal dotfiles managed with [chezmoi](https://www.chezmoi.io/).
|
|
|
|
Per-host configuration is handled with Go templates, so the same repo works on
|
|
every machine:
|
|
|
|
| Host | Type | Notes |
|
|
|---|---|---|
|
|
| `flow` | desktop, personal | DP-1/DP-2 outputs, pulsemeeter, teams-for-linux |
|
|
| `gata` | desktop, work | two monitors, teams-for-linux |
|
|
| `framework13pro` | laptop, personal | eDP-1, touchpad, brightness keys |
|
|
|
|
## Setup on a new machine
|
|
|
|
```sh
|
|
sudo pacman -S chezmoi
|
|
chezmoi init --apply git@gitea.itspm.cc:pmcc/dotfiles
|
|
```
|
|
|
|
For hosts not yet covered (`flow`, `gata`), fill in the `# TODO` output lines:
|
|
|
|
1. `swaymsg -t get_outputs | jq -r '.[].name'`
|
|
2. Edit `dot_config/sway/config.d/outputs.conf.tmpl` in the source, replacing the TODOs with real `output` lines (one per monitor, e.g. `output DP-1 mode 2560x1440@144Hz position 0 0`)
|
|
3. For gata, also replace the `// TODO` in `dot_config/waybar/config.jsonc.tmpl` with the correct monitor names
|
|
4. `chezmoi apply` then `swaymsg reload`
|
|
|
|
## Cheatsheet
|
|
|
|
| Command | What it does |
|
|
|---|---|
|
|
| `chezmoi edit <path>` | Edit the source state of a managed file (`chezmoi edit ~/.tmux.conf`) |
|
|
| `chezmoi edit --apply <path>` | Edit and apply in one step |
|
|
| `chezmoi add <path>` | Add a new file to dotfiles |
|
|
| `chezmoi re-add <path>` | Pull a live-edited file back into source |
|
|
| `chezmoi status` | Show pending changes (target vs source) |
|
|
| `chezmoi diff` | Preview what `apply` would change |
|
|
| `chezmoi apply -v` | Apply source → home |
|
|
| `chezmoi update` | Pull latest from gitea + apply |
|
|
| `chezmoi cd` | Jump to the source dir (`~/.local/share/chezmoi`) — commit/push from here |
|
|
| `chezmoi managed` / `chezmoi unmanaged` | List managed / unmanaged files |
|
|
| `chezmoi data` | Show template variables (e.g. `hosttype` for this host) |
|
|
| `chezmoi doctor` | Diagnose setup issues |
|
|
|
|
Typical workflow: `chezmoi cd` → edit files → `git commit && git push` → on
|
|
other machines `chezmoi update`.
|
|
|
|
## How per-host config works
|
|
|
|
- `.chezmoi.toml.tmpl` maps the hostname to a `hosttype` data variable
|
|
(`laptop` / `desktop`) in `~/.config/chezmoi/chezmoi.toml`
|
|
- `dot_config/sway/config.d/*.tmpl` branch per hostname (outputs) or per
|
|
`hosttype` (inputs, binds) — deployed into `~/.config/sway/config.d/`, which
|
|
the base sway config includes via `include ~/.config/sway/config.d/*`
|
|
- `dot_config/waybar/config.jsonc.tmpl` renders the bar array per host; shared
|
|
bar/module definitions live in `.chezmoitemplates/`
|
|
- `.chezmoiignore.tmpl` scopes app configs to specific hosts:
|
|
pulsemeeter on `flow` only, teams-for-linux on desktop hosts
|
|
|
|
## Template syntax
|
|
|
|
Files ending in `.tmpl` are rendered with Go's `text/template` and deployed
|
|
under the same name minus the suffix (`config.jsonc.tmpl` → `config.jsonc`).
|
|
`{{ ... }}` delimits template actions; anything outside them is literal text.
|
|
|
|
**Variables** — built-ins like `.chezmoi.hostname`, `.chezmoi.os`, and custom
|
|
ones from `[data]` in the generated config, here `.hosttype`:
|
|
|
|
```
|
|
{{ if eq .hosttype "laptop" }}
|
|
bindsym XF86MonBrightnessUp exec brightnessctl s +5%
|
|
{{ end }}
|
|
```
|
|
|
|
**Conditionals**:
|
|
|
|
```
|
|
{{ if eq .chezmoi.hostname "flow" }}...{{ else if eq .hosttype "laptop" }}...{{ end }}
|
|
```
|
|
|
|
**Whitespace control** — `{{-` trims whitespace before the action, `-}}`
|
|
trims after; this keeps conditionals from leaving stray blank lines in the
|
|
output.
|
|
|
|
**Shared fragments** — `.chezmoitemplates/` files are included with
|
|
`{{ template "name" . }}`, optionally passing data:
|
|
|
|
```
|
|
{{ template "bar-primary" (dict "out" "eDP-1" "ws" (list "1" "2" "3" "4")) }}
|
|
```
|
|
|
|
**Previewing** without touching your home dir:
|
|
|
|
```sh
|
|
# render one template for a specific host
|
|
chezmoi execute-template --init --override-data '{"chezmoi":{"hostname":"flow"}}' < file.tmpl
|
|
|
|
# render the whole source state into a scratch dir
|
|
mkdir -p /tmp/test && chezmoi --source ~/.local/share/chezmoi apply --destination /tmp/test
|
|
```
|
|
|
|
Note: templates that render to empty output are not deployed — that's why
|
|
`flow`/`gata` have no `inputs.conf`/`binds.conf`.
|
|
|
|
## What each chezmoi file does
|
|
|
|
| Source file | Deploys as | Purpose |
|
|
|---|---|---|
|
|
| `dot_zshrc`, `dot_tmux.conf` | `~/.zshrc`, `~/.tmux.conf` | plain dotfiles (`dot_` → leading dot) |
|
|
| `dot_config/…` | `~/.config/…` | config tree |
|
|
| `executable_install.sh` | `install.sh` with `+x` | scripts — executability needs the `executable_` prefix; chezmoi ignores the source file's own mode |
|
|
| `*.tmpl` | same name, rendered | per-host / templated content |
|
|
| `.chezmoi.toml.tmpl` | `~/.config/chezmoi/chezmoi.toml` (at `chezmoi init`) | defines `[data]` variables like `hosttype` |
|
|
| `.chezmoiignore.tmpl` | *(never deployed)* | patterns matched against **target** paths to skip, template-capable |
|
|
| `.chezmoitemplates/*` | *(never deployed)* | shared template fragments, included with `{{ template "name" . }}` |
|
|
|
|
## Package lists
|
|
|
|
`~/.config/dotfiles/install.sh` installs the packages from the rendered
|
|
`packages.txt` (official repos) and `aur-packages.txt` (AUR). The lists are
|
|
templates too, so host-specific software (pulsemeeter, teams-for-linux) is only
|
|
installed where it's used. The lists intentionally only cover software with
|
|
configs in this repo — the base OS install is assumed to already exist.
|