bil0u / .dotfiles

macOS / Windows automated bootstrapping using https://chezmoi.io

Personal computers bootsrapping made easy

Installation • Frequent commands • Documentation • Credits

💬 Intro

These are my dotfiles, managed with chezmoi. Take anything you want, but use at your own risk.

I'm using it to manage my macOS and Windows environments.

🚧 Installation

macOS

You can either use the install.sh script if you cloned the repo locally, or use this one liner to do a remote install:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/bil0u/.dotfiles/main/install.sh)" -- -r

Windows

You can either use the install.ps1 script if you cloned the repo locally, or use this one liner to do a remote install:

$installer = "$env:temp\dot-install.ps1"; Invoke-WebRequest "https://raw.githubusercontent.com/bil0u/.dotfiles/main/install.ps1" -OutFile "$installer"; PowerShell.exe -ExecutionPolicy Bypass -File "$installer" -Remote; Exit;

Finally, you should check for any manual steps to complete the installation.

♻️ Frequent commands

# Checks for common problems
dot doctor

# Adds a $FILE from the home directory to the source directory
dot add $FILE [--follow --template --autotemplate --encrypt ...]

# Opens your editor with the file in the source directory that corresponds to $FILE
dot edit $FILE

# Updates the dotfiles from the source directory.
dot apply

# Pulls the latest changes from the remote repo and runs chezmoi apply
dot update

# Full removal of both dotfiles and chezmoi
dot update

# NOTE: `dot` is an alias for `chezmoi`

For full list, see command overview, and daily operations

📚 Documentation

    docs
      ├ darwin: macOS related documentation
      ├ windows: Windows related documentation       ├ manual-steps: Steps to do manually to complete the installation       └ resources: Useful resources used for the project

🎉 Credits

• Tom Payne for writing chezmoi
• Ian Gregory for defaults-edit
• Chirag Davé for plistwatch
• Zachary Cutlip for prefsniff
• Mathias Bynens for his work on macOS defaults