https://github.com/emylfy/macrift
Interactive macOS setup & customization tool — tweaks, apps, security, dotfiles and cleanup in one TUI
https://github.com/emylfy/macrift
automation bash cli dotfiles dotfiles-macos homebrew macos macos-customization macos-defaults macos-setup shell-script terminal tui
Last synced: about 1 month ago
JSON representation
Interactive macOS setup & customization tool — tweaks, apps, security, dotfiles and cleanup in one TUI
- Host: GitHub
- URL: https://github.com/emylfy/macrift
- Owner: emylfy
- License: mit
- Created: 2025-02-24T07:55:24.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-15T19:42:54.000Z (2 months ago)
- Last Synced: 2026-04-15T21:30:40.746Z (2 months ago)
- Topics: automation, bash, cli, dotfiles, dotfiles-macos, homebrew, macos, macos-customization, macos-defaults, macos-setup, shell-script, terminal, tui
- Language: Shell
- Homepage: https://git.new/macrift
- Size: 318 KB
- Stars: 8
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Security: security/menu.sh
Awesome Lists containing this project
README
# macrift
**Preview every macOS change before it happens — then apply with one key**
Why macrift? ·
Quick Start ·
Features ·
Customize
---
## Why macrift?
Fresh Mac → full setup in minutes.
- **See before you touch** — tweak wizard with per-item skip, apply, or reset. 80+ tweaks across 9 categories, all audited
- **82 curated packages** — 7 Homebrew bundles + Mac App Store, installed via multi-select
- **12 bundled configs** — terminal profiles, shell aliases, Catppuccin theme, editor settings, dock layout — ready to apply
- **Profile save/restore** — save your entire setup (Brewfile, macOS defaults, dotfiles, editor settings, iTerm2, dock layout, Raycast) to Desktop, Documents, or iCloud Drive and restore it anywhere
---
## Quick Start
```bash
curl -fsSL https://raw.githubusercontent.com/emylfy/macrift/main/install.sh | bash
```
Installs to `~/.macrift`, creates a global `macrift` command, and launches automatically.
Doesn't touch your system until you choose what to apply.
Alternative install methods
**Git clone:**
```bash
git clone https://github.com/emylfy/macrift.git ~/.macrift && ~/.macrift/macrift.sh
```
**Manual download:** grab the [latest archive](https://github.com/emylfy/macrift/archive/main.tar.gz), extract to `~/.macrift`, and run `~/.macrift/macrift.sh`
CLI flags
| Flag | Description |
| :------------- | :-------------------------------------------- |
| `--dry-run` | Show what would change without applying |
| `--no-confirm` | Skip all confirmation prompts (auto-approve) |
| `--log` | Write session log to `~/.macrift/macrift.log` |
| `--uninstall` | Remove macrift from this system |
| `--help` | Show usage info |
---
## Features
| | Feature | What it does |
| :-- | :--------------------- | :-------------------------------------------------------------------------------- |
| ⚙️ | **System Tweaks** | Dock, Finder, Keyboard, Trackpad, Screenshots, Misc, Privacy |
| 📦 | **Apps & Packages** | 7 Homebrew bundles, Mac App Store, Spotify, .brewbak backup |
| 🎨 | **Customize** | Profile, Terminal, Shell, Editor, Claude Code, Dock Layout, Launchpad, Wallpapers |
| 🛡️ | **Security & Privacy** | Security status, hostname, DNS benchmark, update control |
| 🧹 | **Cleanup** | System cleanup via Mole — caches, logs, leftovers |
### ⚙️ System Tweaks
Tweak wizard with per-item skip, apply, or reset to system default. Batch apply or pick individually.
| Category | What it does |
| :--------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Dock | Tile size, animation speed, minimize effect, Spaces, recents |
| Finder | Show hidden files & extensions, path bar, POSIX title, list view, no .DS_Store, quit menu, spring folders |
| Keyboard & Text | Key repeat speed, press-and-hold, auto-correct, smart substitutions |
| Trackpad & Mouse | Tap to click, tracking speed, right-click, three-finger drag, drag windows anywhere |
| Screenshots | Format, save location, shadow, date in filename |
| Hot Corners | Single grid screen, space to cycle actions per corner |
| Misc | Boot sound, app open dialog, Safari search engine, save/print panels, window animations, tiled margins |
| Privacy | Ad tracking, firewall, stealth mode, guest access, screen lock, analytics, Siri, AirDrop, Gatekeeper |
| Dithering | Apple Silicon — disable GPU/DCP temporal dithering ([Stillcolor](https://github.com/aiaf/Stillcolor) port) via headless LaunchAgent daemon, no menu bar app |
| Space Switcher | Instant macOS workspace switching — Instant macOS workspace switching via Ctrl+←/→ daemon |
### 📦 Apps & Packages
**Homebrew Bundles** — multi-select installer with 7 curated Brewfiles + fzf search across all packages:
- **Development** — bash, git, gh, lazygit, node, python, go, rust, docker, neovim, tmux, fzf, ripgrep, bat, eza, fd, tlrc, fastfetch, claude, claude-code, zed, t3-code...
- **Utilities** — Raycast, Alfred, HiddenBar, AltTab, Keka, BetterDisplay, Cork, Keyboard Cowboy, Logi Options+...
- **Browsers** — Chrome, Arc, Zen, Ungoogled Chromium
- **Communication** — Ayugram, Telegram, Discord, Vesktop, Slack, Zoom
- **Media** — IINA, OBS, Spotify, Figma, Affinity
- **Games** — Steam, Heroic Games Launcher, Modrinth
- **Fonts** — Fira Code, Maple Mono (Nerd Fonts)
**Mac App Store** — `mas` entries in Brewfiles installed individually with App Store redirect for unpurchased apps.
Export/import your packages with `.brewbak` backup files.
**Spotify** — [SpotX](https://github.com/SpotX-Official/SpotX-Bash) ad blocker + [Spicetify](https://spicetify.app) customization framework + marketplace settings save/restore.
### 🛡️ Security & Privacy
| Tool | Description |
| :------------------ | :--------------------------------------------------------------------------- |
| **Security Status** | FileVault, Firewall, SIP, Gatekeeper — at a glance; toggle Gatekeeper on/off |
| **Hostname** | Set custom hostname — hide your name from the network |
| **DNS** | 11 providers, benchmark with current DNS comparison, VPN detection |
| **Update Control** | Defer macOS upgrades via MDM profile — 30/60/90 days, status, install/remove |
### 🧹 Cleanup
- **Homebrew Cleanup** — `brew cleanup --prune=all && brew autoremove`
- **Deep Clean** — powered by [Mole](https://github.com/tw93/mole), removes caches, logs, and leftover files
---
## Customize
Complete environment setup from one menu.
### 🖥️ Terminal & Shell
**Terminal** — install & configure [iTerm2](https://iterm2.com) or [Ghostty](https://ghostty.org):
- **iTerm2 Dynamic Profiles** — 3 presets (Cyberdrift, Nord Frost, Tokyo Night) with FiraCode Nerd Font, auto-set as default
- **iTerm2 Defaults** — GPU renderer, compact tabs, hidden scrollbar, focus follows mouse
- **Ghostty** — config from `config/ghostty/`; Catppuccin Mocha and Latte themes downloaded automatically
**Shell** — [Zinit](https://github.com/zdharma-continuum/zinit) plugin manager + [Starship](https://starship.rs) prompt + [FastFetch](https://github.com/fastfetch-cli/fastfetch) + `.zshrc` with modern aliases:
- **Zinit plugins** — fast-syntax-highlighting, zsh-autosuggestions, zsh-completions, fzf-tab (turbo/async)
- **Catppuccin Mocha** — one-click theme for fzf, bat, eza, autosuggestions, syntax highlighting, starship
Shell aliases
| Alias | Tool |
| :-------------------- | :--------------------------------------------------------------------- |
| `ls` `ll` `lt` | [eza](https://github.com/eza-community/eza) with icons and tree view |
| `cat` | [bat](https://github.com/sharkdp/bat) with syntax highlighting |
| `grep` | [ripgrep](https://github.com/BurntSushi/ripgrep) |
| `find` | [fd](https://github.com/sharkdp/fd) |
| `g` `gs` `ga` `gc` | git shortcuts (status, add, commit, push, log, diff, checkout, branch) |
| `lg` | [lazygit](https://github.com/jesseduffield/lazygit) |
| `..` `...` `....` | quick directory navigation |
| `reload` `ip` `ports` | shell reload, public IP, listening ports |
### 📝 Code Editors
Shared `settings.json` applied to any of these editors:
- [VSCode](https://code.visualstudio.com) · [Cursor](https://cursor.sh) · [Windsurf](https://codeium.com/windsurf) · [VSCodium](https://vscodium.com) · [Zed](https://zed.dev)
Fira Code, format on save, ligatures, sidebar left, telemetry off.
**Extensions** — multi-select installer from `config/vscode/extensions.txt`; auto-detects `code`/`cursor`/`codium` CLI.
🗂️ Dock Layout
Dock management via [dockutil](https://github.com/kcrawford/dockutil):
- **Save/Restore** — save current layout and restore it on another Mac
- **Clear Dock** — remove all apps for a clean start
- **Add spacer** — visual separator between groups
- **Reset** — restore macOS default dock
🚀 Launchpad
Organize Launchpad apps into folders by App Store category:
- **Sort by category** — auto-detects app categories via metadata, creates folders (Developer Tools, Productivity, Utilities, etc.), merges small categories into Other
- **Reset to default** — full Launchpad reset to factory layout
🖼️ Wallpapers
- [Catppuccin wallpapers](https://github.com/zhichaoh/catppuccin-wallpapers)
- [Gruvbox wallpapers](https://github.com/AngelJumworworbo/gruvbox-wallpapers)
- [wallhaven.cc](https://wallhaven.cc)
- [Curated collection](https://raindrop.io/emalfai/wallpaper-69077386)
📦 Profile Save & Restore
Save your entire environment to Desktop, Documents, or iCloud Drive. Restore on another Mac or after a clean install with multiselect.
Includes: Brewfile, macOS defaults (Dock, Finder, Keyboard, Screenshots), dotfiles (.zshrc, Starship, FastFetch, Ghostty), editor settings (VSCode, Cursor, Zed), iTerm2 config, dock layout, and Raycast extensions.
---
[MIT License](LICENSE) · [Changelog](CHANGELOG.md) · [Report a Bug](https://github.com/emylfy/macrift/issues)
If this saved you time, a star helps others find it