{"id":13479292,"url":"https://github.com/ahmadawais/dotfiles","last_synced_at":"2026-03-16T23:37:02.586Z","repository":{"id":66346950,"uuid":"42216424","full_name":"ahmadawais/dotfiles","owner":"ahmadawais","description":"A non-exhaustive collection of my dotfiles.","archived":false,"fork":false,"pushed_at":"2025-02-14T00:07:30.000Z","size":13669,"stargazers_count":33,"open_issues_count":0,"forks_count":7,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-14T22:09:13.930Z","etag":null,"topics":["bash","dotfiles","zshrc"],"latest_commit_sha":null,"homepage":"https://twitter.com/MrAhmadAwais/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahmadawais.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-09-10T02:15:15.000Z","updated_at":"2025-02-24T12:07:31.000Z","dependencies_parsed_at":"2023-02-22T02:16:12.049Z","dependency_job_id":"c4f081d9-52c0-4a14-b9ac-c339b2fd2ac7","html_url":"https://github.com/ahmadawais/dotfiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmadawais%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmadawais%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmadawais%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmadawais%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahmadawais","download_url":"https://codeload.github.com/ahmadawais/dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248968914,"owners_count":21191162,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","dotfiles","zshrc"],"created_at":"2024-07-31T16:02:12.967Z","updated_at":"2026-03-16T23:37:02.580Z","avatar_url":"https://github.com/ahmadawais.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Mac Setup\n\n\u003e Automated macOS setup script for a fresh Mac installation. Installs apps, CLI tools, configures system preferences, and sets up the development environment.\n\n## Quick Start\n\n```bash\n# Clone the repo\ngit clone https://github.com/ahmadawais/dotfiles.git\ncd dotfiles\n\n# Make executable and run\nchmod +x mac-setup.sh\n./mac-setup.sh\n```\n\n## What Gets Installed\n\n### CLI Tools\n\n| Tool | Description |\n|------|-------------|\n| `wget` | Network downloader |\n| `bat` | Better `cat` with syntax highlighting |\n| `mackup` | Backup app settings to cloud |\n| `pv` | Pipe progress viewer |\n| `jq` | JSON processor |\n| `ffmpeg` | Media converter |\n| `yt-dlp` | YouTube downloader |\n| `composer` | PHP package manager |\n| `gh` | GitHub CLI |\n| `eza` | Modern `ls` replacement |\n\n### Applications\n\n#### Terminals\n- **Ghostty** - GPU-accelerated terminal\n- **iTerm2** - Feature-rich terminal\n\n#### Browsers\n- Google Chrome\n\n#### Development\n- Visual Studio Code + Insiders\n- Postman\n- Local (WordPress)\n- GPG Suite\n\n#### Productivity\n- Raycast (launcher)\n- Rectangle (window management)\n- Maccy (clipboard manager)\n- Dropbox\n\n#### Communication\n- Zoom\n- Microsoft Teams\n- Discord\n- WhatsApp\n\n#### Media\n- VLC\n- IINA\n- ImageOptim\n- WebTorrent\n\n#### Utilities\n- Mounty (NTFS support)\n- Cursorcerer (auto-hide cursor)\n- Macs Fan Control\n- Cloudflare WARP\n- Karabiner Elements\n- OBS Studio\n- Tunnelblick (VPN)\n\n#### Pro Apps (Licensed)\n- ScreenFlow\n- Rocket\n- ColorSnapper\n- ForkLift\n- Setapp\n\n### Node.js Setup\n\n- **n** - Node version manager\n- Node.js LTS\n- npm\n- pnpm\n- git-open (global package)\n\n### Shell Setup\n\n- Oh My Zsh\n- zsh-autosuggestions plugin\n- zsh-syntax-highlighting plugin\n- Shades of Purple theme\n\n### macOS Preferences\n\nThe script configures these system preferences:\n\n#### Finder\n- Allow quitting via Cmd+Q\n- Show hidden files\n- Show all file extensions\n- Show path bar and status bar\n- List view by default\n- Folders on top when sorting\n\n#### System\n- Expanded save/print dialogs\n- Fast key repeat rate\n- Disabled auto-correct\n- Tap to click enabled\n- Auto-hide Dock (no delay)\n\n#### Screenshots\n- Saved to `~/Desktop/Screenshots`\n- Shadows disabled\n\n#### Apps\n- Safari: Full URL + Developer menu\n- TextEdit: Plain text mode\n- Activity Monitor: Show all processes\n- VLC: History cleared\n\n## Post-Installation\n\nAfter the script completes:\n\n1. **Restart your Mac** to apply all system changes\n2. **Configure zsh** - Add plugins to `~/.zshrc`:\n   ```bash\n   plugins=(git zsh-autosuggestions zsh-syntax-highlighting)\n   ZSH_THEME=\"shades-of-purple\"\n   ```\n3. **Check manual.md** for:\n   - License activation instructions\n   - Manual app installations\n   - Theme setup guides\n\n## File Structure\n\n```\ndotfiles/\n├── mac-setup.sh    # Main setup script\n├── manual.md       # Post-install manual steps\n├── readme.md       # This file\n└── .zshrc          # Zsh configuration\n```\n\n## Customization\n\n### Adding Apps\n\nAdd brew formulas or casks in the appropriate section:\n\n```bash\n# CLI tool\nbrew install tool-name\n\n# GUI app\nbrew install --cask app-name\n```\n\n### Modifying Preferences\n\nmacOS defaults are in the \"macOS PREFERENCES\" section. Reference:\n- https://macos-defaults.com/\n- https://mths.be/macos\n\n## Requirements\n\n- macOS (tested on Ventura, Sonoma, Sequoia)\n- Admin privileges (for sudo)\n- Internet connection\n\n## Compatibility\n\n- **Intel Macs**: Full support\n- **Apple Silicon (M1/M2/M3)**: Full support with automatic Homebrew path configuration\n\n## Credits\n\nInspired by:\n- [mathiasbynens/dotfiles](https://github.com/mathiasbynens/dotfiles)\n- [mths.be/macos](https://mths.be/macos)\n\n## Author\n\n**Ahmad Awais** - [@_AhmadAwais_](https://x.com/_AhmadAwais_)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmadawais%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahmadawais%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmadawais%2Fdotfiles/lists"}