Files
.dotfiles/README.md
T

56 lines
1.7 KiB
Markdown

# Personal dotfiles
These are my config files for macOS and KDE, managed with GNU Stow. You need `stow` and `zsh` installed.
## Installation
```sh
git clone https://git.trivk.dev/tri/.dotfiles.git "$HOME/.dotfiles"
cd "$HOME/.dotfiles"
```
The packages are split into three groups:
- [common/](common/README.md) has Fastfetch, Git, Micro, mpv, npm, Starship and Zsh.
- [mac/](mac/README.md) has Ghostty.
- [kde/](kde/README.md) has the Darwin Breeze theme, Helium, Spectacle and tray icons.
Install all of `common`, then the group for your platform:
```sh
(cd common && stow -t "$HOME" */)
(cd mac && stow -t "$HOME" */) # macOS
(cd kde && stow -t "$HOME" */) # KDE
```
`*/` matches every package in the group. Each line runs in a subshell, so you stay in the repo root and can run them one after another. KDE needs a few more steps after this. They're in [`kde/README.md`](kde/README.md).
### Picking packages
You don't have to install everything. List only the packages you want:
```sh
stow -d common -t "$HOME" git zsh starship
stow -d mac -t "$HOME" ghostty
stow -d kde -t "$HOME" spectacle
```
`-d` tells Stow which group to read from. `-t` puts the symlinks in your home directory. You can mix packages from different groups.
### Previewing and removing
`-n -v` prints what Stow would do and changes nothing. `-D` removes the symlinks. Pass the same `-d` and `-t` you used to install:
```sh
stow -n -v -d kde -t "$HOME" spectacle
stow -D -d kde -t "$HOME" spectacle
```
Once the Zsh config is linked, run `exec zsh` to reload the shell.
## Credits
- [Machfiles](https://github.com/ChristianChiarulli/Machfiles/)
- [zsh_unplugged](https://github.com/mattmc3/zsh_unplugged)
- [ayanrajpoot10/dotfiles](https://github.com/ayanrajpoot10/dotfiles)