Skip to content

README.md

Latest commit

 

History

History
137 lines (97 loc) · 4.29 KB

README.md

File metadata and controls

137 lines (97 loc) · 4.29 KB

Dotfiles

My dotfiles for macOS and Linux (Ubuntu 24.04).

Some files (for example raycast configuration) are encrypted and can only be decrypted with my private password. Do not use the dotfiles as-is but as a base for your configuration.

Initial Setup

If this is your first time setting up this dotfiles repository on a new machine:

1. Generate SSH Key

ssh-keygen -t ed25519 -C "your_email@example.com"
# Press Enter to accept default location (~/.ssh/id_ed25519)
# Enter a passphrase (recommended)

# macOS: add SSH key to Keychain (stores passphrase)
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

# Linux: add SSH key to agent
ssh-add ~/.ssh/id_ed25519

2. Add SSH Key to GitHub

# macOS
pbcopy < ~/.ssh/id_ed25519.pub

# Linux
xclip -sel clip < ~/.ssh/id_ed25519.pub

Then go to GitHub SSH Settings and add your ssh key.

3. Clone the Repository

cd ~
git clone git@github.com:cyprieng/dotfiles.git
cd dotfiles

4. Install

make install

This will run the full installation process (auto-detects macOS or Linux).

Available Commands

Run make help to see all available commands:

  • make install - Full installation (auto-detects OS)
  • make install-macos / make install-linux - OS-specific full installation
  • make stow - Symlink all dotfiles
  • make unstow - Remove all symlinks
  • make init - Install prerequisites (brew on macOS, apt on Linux)
  • make deps - Install all dependencies
  • make setup - Configure apps & system settings
  • make tools - Install language tools via mise + uv (runs after stow)
  • make extra - Install extra applications and configurations (macOS only)
  • make update - Update everything
  • make clean - Clean up broken symlinks and Homebrew cache
  • make backup - Backup app configurations (macOS only)

Manual process (macOS)

macOS Settings

  • Reduce animations: Apple menu > System Settings > Accessibility > Motion > Turn on Reduce motion
  • Add qwerty-fr: Apple menu > System Settings > Keyboard > Input Sources > Add qwerty-fr from Others
  • Hide menu bar items: Apple menu > Menu Bar > Hide everything except Aerospace and AlDente (replace native battery with it)

Apps on startup

Make sure the following apps run on startup:

  • Aerospace
  • AlDente
  • CleanShotX
  • Hammerspoon
  • Raycast
  • Karabiner
  • BetterTouchTool

Dock

Rearrange Dock:

  • Safari
  • Chrome
  • Claude
  • Mail
  • Ghostty
  • Obsidian

Zen / Chrome

Install the following chrome extensions:

The following Safari extensions:

Add the following bookmarks to the bookmarks bar:

Others

Install CleanMyMac

Change the wallpaper using the ones from wallpaper directory.

Do not forget to log out and log back in to make sure all changes are applied.