mirror of
https://github.com/AquaMorph/dotfiles.git
synced 2026-11-03 08:17:59 +00:00
96 lines
2.9 KiB
Markdown
96 lines
2.9 KiB
Markdown
# Dotfiles
|
|
|
|
A collection of config files and scripts for Fedora GNU/Linux and macOS.
|
|
|
|
## Linux installation
|
|
|
|
```bash
|
|
chezmoi init --apply git@github.com:AquaMorph/dotfiles.git
|
|
```
|
|
|
|
## macOS installation
|
|
|
|
1. Install the Xcode Command Line Tools with `xcode-select --install`, then
|
|
install [Homebrew](https://brew.sh/) and follow its `brew shellenv`
|
|
instructions.
|
|
|
|
2. Download the dotfiles without applying them, then install dependencies:
|
|
|
|
```bash
|
|
brew install chezmoi
|
|
chezmoi init git@github.com:AquaMorph/dotfiles.git
|
|
brew bundle --file="$(chezmoi source-path ~/.brewfile)"
|
|
```
|
|
|
|
3. Restore your password store to `~/.password-store` and import its GPG private
|
|
key from a secure backup before applying the dotfiles:
|
|
|
|
```bash
|
|
gpg --import /path/to/private-key-backup.asc
|
|
```
|
|
|
|
If the store is kept in Git, clone it to `~/.password-store` using your
|
|
password-store repository URL. Verify that all required secrets can be
|
|
decrypted without printing their values:
|
|
|
|
```bash
|
|
pass show self-host/token/audible-activation-bytes >/dev/null
|
|
pass show self-host/token/aquaai >/dev/null
|
|
pass show self-host/token/todoist >/dev/null
|
|
```
|
|
|
|
`settings.conf` is rendered using `pass`, so applying it requires these
|
|
entries and the matching private key. Never commit keys or plaintext tokens.
|
|
|
|
4. Review and apply the dotfiles, then open a new terminal:
|
|
|
|
```bash
|
|
chezmoi diff
|
|
chezmoi apply
|
|
```
|
|
|
|
Linux-only configuration and scripts are automatically ignored on macOS.
|
|
|
|
To install newly added macOS dependencies later:
|
|
|
|
```bash
|
|
brew bundle --file="$(chezmoi source-path ~/.brewfile)"
|
|
```
|
|
|
|
### System preferences
|
|
|
|
Close System Settings, then review and run the optional setup script as your
|
|
normal user (not with `sudo`):
|
|
|
|
```bash
|
|
~/bin/setup-macos.sh --dry-run
|
|
~/bin/setup-macos.sh
|
|
```
|
|
|
|
It enables dark mode and Dock auto-hide, disables natural scrolling and
|
|
swipe-to-navigate, and removes window-tiling margins (macOS Sequoia and later).
|
|
Animation settings and machine-specific state, such as Dock contents and
|
|
monitor/Spaces layouts, are left unchanged.
|
|
|
|
The script is safe to rerun but does not back up previous values or run
|
|
automatically during `chezmoi apply`. Log out and back in if changes are not
|
|
visible.
|
|
|
|
### Window focus
|
|
|
|
Hover focus is disabled in AeroSpace. Leave AutoRaise stopped so moving the
|
|
pointer does not focus or raise windows:
|
|
|
|
```bash
|
|
brew services stop dimentium/autoraise/autoraise
|
|
```
|
|
|
|
Hammerspoon's `~/.hammerspoon/clickthrough.lua` focuses inactive windows on
|
|
mouse-down before passing through the original click, so the same click can
|
|
activate the clicked control. This is a workaround, not a native macOS setting;
|
|
some apps may still consume the first click. Modified clicks are left unchanged.
|
|
Use **Windows → Toggle single-click window activation** to disable it if an app
|
|
misbehaves. Hammerspoon needs Accessibility access and must be running.
|
|
|
|
Optional AutoRaise settings remain in `~/.config/AutoRaise/config`.
|