{"id":16616867,"url":"https://github.com/sebastienrousseau/maccfg","last_synced_at":"2025-03-21T14:31:29.103Z","repository":{"id":57677589,"uuid":"489878227","full_name":"sebastienrousseau/maccfg","owner":"sebastienrousseau","description":"A guide to getting your MacBook Pro M1 ready for Software Development.","archived":false,"fork":false,"pushed_at":"2024-07-11T05:36:36.000Z","size":237,"stargazers_count":8,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-03-13T17:04:44.968Z","etag":null,"topics":["config","configuration-management","devops","devops-tools","mac-config","mac-setup","macbook-pro-m1","macbook-setup","maccfg","macos-config","macos-setup","macosx-setup","osx-setup"],"latest_commit_sha":null,"homepage":"https://sebastienrousseau.github.io/maccfg/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sebastienrousseau.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/funding.yml","license":"LICENSE","code_of_conduct":".github/CODE-OF-CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"sebastienrousseau","custom":"https://paypal.me/wwdseb"}},"created_at":"2022-05-08T07:42:08.000Z","updated_at":"2025-01-11T18:48:49.000Z","dependencies_parsed_at":"2023-02-10T16:00:23.822Z","dependency_job_id":"739da1b0-35b4-4888-82dd-d09947a5abeb","html_url":"https://github.com/sebastienrousseau/maccfg","commit_stats":{"total_commits":10,"total_committers":2,"mean_commits":5.0,"dds":"0.19999999999999996","last_synced_commit":"4ddfae50beffd0452988b04504ea7f27557a1479"},"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebastienrousseau%2Fmaccfg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebastienrousseau%2Fmaccfg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebastienrousseau%2Fmaccfg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebastienrousseau%2Fmaccfg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sebastienrousseau","download_url":"https://codeload.github.com/sebastienrousseau/maccfg/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244815197,"owners_count":20514912,"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":["config","configuration-management","devops","devops-tools","mac-config","mac-setup","macbook-pro-m1","macbook-setup","maccfg","macos-config","macos-setup","macosx-setup","osx-setup"],"created_at":"2024-10-12T02:14:29.214Z","updated_at":"2025-03-21T14:31:28.796Z","avatar_url":"https://github.com/sebastienrousseau.png","language":"Shell","funding_links":["https://github.com/sponsors/sebastienrousseau","https://paypal.me/wwdseb"],"categories":[],"sub_categories":[],"readme":"# Mac M-Series Software Development Setup Guide\n\n![Mac M-Series][00]\n\nWelcome to the ultimate guide for setting up your Mac M-Series for software\ndevelopment. Equip your Mac with the best tools and configurations to boost your\ncoding experience.\n\n[Download maccfg ⧉][01]\n\n## Table of Contents\n\n- [Mac M-Series Software Development Setup Guide](#mac-m-series-software-development-setup-guide)\n  - [Table of Contents](#table-of-contents)\n  - [What's Inside?](#whats-inside)\n  - [Mac M-Series at a glance](#mac-m-series-at-a-glance)\n  - [Repository Contents](#repository-contents)\n  - [Setting Up Your Mac](#setting-up-your-mac)\n  - [Kickstart Your Development Setup](#kickstart-your-development-setup)\n    - [1. Initial Steps](#1-initial-steps)\n    - [2. Install macOS Preferences](#2-install-macos-preferences)\n    - [3. Add Homebrew to your PATH](#3-add-homebrew-to-your-path)\n    - [4. Add Homebrew to your `.zshrc` file](#4-add-homebrew-to-your-zshrc-file)\n  - [Enhancing Your Mac with Homebrew Configurations](#enhancing-your-mac-with-homebrew-configurations)\n    - [1. **GUI Applications with Homebrew Casks**](#1-gui-applications-with-homebrew-casks)\n    - [2. Font Management with Caskroom Fonts](#2-font-management-with-caskroom-fonts)\n    - [3. Browse Packages with Homebrew Formulae](#3-browse-packages-with-homebrew-formulae)\n    - [4. Enhanced File Preview with Homebrew QLPlugins](#4-enhanced-file-preview-with-homebrew-qlplugins)\n  - [Customizing Your macOS Experience](#customizing-your-macos-experience)\n    - [1. Setting macOS Defaults](#1-setting-macos-defaults)\n    - [2. Discover App Store Treasures](#2-discover-app-store-treasures)\n  - [Versioning \\\u0026 Updates](#versioning--updates)\n  - [How to Contribute](#how-to-contribute)\n  - [Community \\\u0026 Values](#community--values)\n  - [Licensing](#licensing)\n  - [Shoutouts \\\u0026 Credits](#shoutouts--credits)\n\n\n## What's Inside?\n\n-   Essential tool installations: Homebrew, Xcode, and more.\n-   Terminal \u0026 shell configurations.\n-   Must-have software and Quick Look plugins.\n-   Customizations to enhance your macOS experience and productivity.\n\nDive in to transform your M-Series Mac into a developer's paradise!\n\n## Mac M-Series at a glance\n\nApple ushered in a new era in late 2020 by transitioning from Intel processors\nto its Apple Silicon in Mac computers, introducing the Mac M-Series.\n\n## Repository Contents\n\nDiscover the source code, recommended software, tools, and libraries for the\nM-Series Development Guide in this repository.\n\n```shell\n├── COPYRIGHT\n├── LICENSE\n├── Makefile\n├── README.md\n├── Report.txt\n├── package.json\n└── src\n    ├── homebrew\n    │   ├── homebrew-casks.sh\n    │   ├── homebrew-fonts.sh\n    │   ├── homebrew-formulae.sh\n    │   └── homebrew-qlplugins.sh\n    └── macOS\n        ├── macOS-appstore.sh\n        ├── macOS-defaults.sh\n        ├── macOS-screensavers.sh\n        └── macOS-setup.sh\n\n4 directories, 14 files\n```\n\n## Setting Up Your Mac\n\nBefore diving into the development setup, ensure your Mac is ready.\nFollow\n[Apple's official documentation](https://support.apple.com/en-gb/guide/macbook-pro/apd831707cb3/mac)\nfor a smooth setup.\n\n## Kickstart Your Development Setup\n\nOnce your Mac is set up, you can begin installing the essential tools for\nsoftware development.\n\n### 1. Initial Steps\n\n-   **Open Terminal**: Access through Launchpad or find it in `/Applications/Utilities`.\n-   **Install Xcode Command Line Tools**: Run `xcode-select --install` in Terminal.\n-   **Install Rosetta 2**: Run `/usr/sbin/softwareupdate --install-rosetta --agree-to-license` in Terminal.\n\n### 2. Install macOS Preferences\n\n-   Open Terminal and run the following command:\n\n``` shell\nchmod +x ./src/macOS/macOS-setup.sh \u0026\u0026 sh ./src/macOS/macOS-setup.sh`\n```\n\nThe script will install the following software:\n\n-   **Homebrew** - The Missing Package Manager for macOS (or Linux),\n-   The **XCode Command Line Tool**,\n-   The **‘locate’ Command** - To track down files, file type, app, extension,\n    etc.\n\n### 3. Add Homebrew to your PATH\n\nYou will need to add Homebrew to your `PATH` environment variable. To do so:\n\n-   Open terminal and run the following command:\n\n``` shell\necho 'eval \"$(/opt/homebrew/bin/brew shellenv)\"' \u003e\u003e /Users/[your-user-name]/.zprofile\neval \"$(/opt/homebrew/bin/brew shellenv)\"\n```\n\nthen restart your terminal.\n\n### 4. Add Homebrew to your `.zshrc` file\n\nAdd Homebrew to your path, edit your `.zshrc` file and add the following at\nthe bottom.\n\n``` shell\nexport PATH=/opt/homebrew/bin:$PATH\nexport PATH=/opt/homebrew/sbin:$PATH\n```\n\n## Enhancing Your Mac with Homebrew Configurations\n\nDive deep into the power of Homebrew by extending its capabilities. Here's how\nyou can utilize Homebrew to its fullest:\n\n### 1. **GUI Applications with Homebrew Casks**\n\nHomebrew Cask elevates Homebrew by simplifying the installation and management\nof GUI macOS applications, including popular ones like Atom and Google Chrome.\n\nTo get started with Homebrew Casks:\n\n``` shell\nchmod +x ./src/homebrew/homebrew-casks.sh \u0026\u0026 sh ./src/homebrew/homebrew-casks.sh\n```\n\n### 2. Font Management with Caskroom Fonts\n\nHarness the power of Caskroom Fonts to manage a vast collection of fonts\ndirectly from your terminal through Homebrew Cask.\n\nInstall a curated selection of fonts:\n\n``` shell\nchmod +x ./src/homebrew/homebrew-fonts.sh \u0026\u0026 sh ./src/homebrew/homebrew-fonts.sh\n```\n\nEnjoy access to over 1946 freely-distributable fonts. Search, install, or\nuninstall them just like any Homebrew Cask application.\n\n### 3. Browse Packages with Homebrew Formulae\n\nHomebrew Formulae serves as an online package browser specifically for Homebrew,\ncatering to both macOS and Linux.\n\nTo utilize Homebrew Formulae:\n\n``` shell\nchmod +x ./src/homebrew/homebrew-formulae.sh \u0026\u0026 sh ./src/homebrew/homebrew-formulae.sh\n```\n\n### 4. Enhanced File Preview with Homebrew QLPlugins\n\nExperience Quick Look's capability to swiftly preview almost any file type without the need to open them. Trigger QuickLook plugins with a simple SPACE bar press in Finder.\n\nCheck your current plugins with:\n\n``` shell\nqlmanage -m plugins\n```\n\nInstall a handpicked list of Quick Look plugins tailored for developers:\n\n``` shell\nchmod +x ./src/homebrew/homebrew-qlplugins.sh \u0026\u0026 sh ./src/homebrew/homebrew-qlplugins.sh\n```\n\nCongratulations, you've now harnessed the complete power of Homebrew!\n\n## Customizing Your macOS Experience\n\nTailor your Mac settings and preferences to fit your needs. Here's a\nstep-by-step guide to get your macOS looking and behaving the way you want:\n\n### 1. Setting macOS Defaults\n\nThe macOS defaults tool interfaces directly with the macOS preferences system,\nallowing many apps to seamlessly manage settings and preferences.\n\nTo configure macOS defaults, execute the following in your Terminal:\n\n``` shell\nchmod +x ./src/macOS/macOS-defaults.sh \u0026\u0026 sh ./src/macOS/macOS-defaults.sh\n```\n\n### 2. Discover App Store Treasures\n\nNavigate through a curated list of essential App Store software, all accessible\nthrough the Mac App Store's command-line interface.\n\nTo start exploring and installing:\n\n``` shell\nchmod +x ./src/macOS/macOS-appstore.sh \u0026\u0026 sh ./src/macOS/macOS-appstore.sh\n```\n\n## Versioning \u0026 Updates\n\nAdhering to [semantic versioning](http://semver.org/) ensures consistent\nupdates. Refer to \n[GitHub Releases](https://github.com/sebastienrousseau/maccfg/releases) for the\nchangelog.\n\n## How to Contribute\n\nYour contributions can make this guide even better! Check our \n[Contributing Guidelines](https://github.com/sebastienrousseau/maccfg/blob/main/.github/CONTRIBUTING.md)\nto get started.\n\n## Community \u0026 Values\n\nJoin a community that values diversity and inclusivity. Familiarize yourself\nwith our [Code of Conduct](https://github.com/sebastienrousseau/maccfg/blob/main/.github/CODE-OF-CONDUCT.md).\n\nOur beliefs:\n\n-   Perfection encompasses everything.\n-   Passion transcends code.\n-   Obsession with excellence in solutions.\n\n## Licensing\n\nThis project embraces the MIT License. View [LICENSE details](https://github.com/sebastienrousseau/maccfg/blob/main/LICENSE).\n\n## Shoutouts \u0026 Credits\n\n[macOS Config](https://maccfg.com) is a masterpiece crafted by [Sebastien Rousseau](https://sebastienrousseau.co.uk) and other incredible [contributors](https://github.com/sebastienrousseau/maccfg/graphs/contributors).\n\nCrafted with ❤ in London.\n\n\n[00]: https://kura.pro/maccfg/images/banners/maccfg.webp \"Maccfg - Mac M-Series Software Development Setup Guide\"\n[01]: https://github.com/sebastienrousseau/maccfg/releases \"Maccfg Download\"\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsebastienrousseau%2Fmaccfg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsebastienrousseau%2Fmaccfg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsebastienrousseau%2Fmaccfg/lists"}