{"id":25590846,"url":"https://github.com/nikdata/setting-up-my-mac","last_synced_at":"2026-03-01T05:03:16.437Z","repository":{"id":278084689,"uuid":"934448834","full_name":"nikdata/setting-up-my-mac","owner":"nikdata","description":"Brief tutorial on how I set up a new Mac","archived":false,"fork":false,"pushed_at":"2025-02-17T22:33:40.000Z","size":5,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-11T05:16:25.496Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"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/nikdata.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":"2025-02-17T21:15:31.000Z","updated_at":"2025-02-17T22:33:44.000Z","dependencies_parsed_at":"2025-02-17T23:35:50.922Z","dependency_job_id":null,"html_url":"https://github.com/nikdata/setting-up-my-mac","commit_stats":null,"previous_names":["nikdata/setting-up-my-mac"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/nikdata/setting-up-my-mac","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikdata%2Fsetting-up-my-mac","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikdata%2Fsetting-up-my-mac/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikdata%2Fsetting-up-my-mac/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikdata%2Fsetting-up-my-mac/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nikdata","download_url":"https://codeload.github.com/nikdata/setting-up-my-mac/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nikdata%2Fsetting-up-my-mac/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29960262,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T01:47:18.291Z","status":"online","status_checked_at":"2026-03-01T02:00:07.437Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-02-21T09:31:40.646Z","updated_at":"2026-03-01T05:03:16.402Z","avatar_url":"https://github.com/nikdata.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"WIP 🚧 🏗 \n\nHello! 👋🏽\n\nOver the years, I've become accustomed to using certain applications (both work \u0026 personal) using macOS. As anyone knows, when you buy a new Mac (or any computer for that matter), you'll want to spend a little bit of time configuring it to your liking. \n\nSome of the apps that I frequently use:\n\n- PyCharm\n- VSCode\n- Python, R\n- RStudio\n- Docker \u0026 Orbstack\n\nIn addition to those, I also use quite a few handy applications that help make my life a bit easier.\n\nIn this brief guide, I'll go over the basic applications I use:\n\n- [Setting up Homebrew](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#homebrew)\n- [Improving Terminal \u0026 Configuring](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#make-terminal-better)\n- [Setting up git](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#git)\n- [Configuring GitHub with SSH key](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#github--ssh-key)\n- [Setting up Python](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#python)\n- [Setting up R](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#r)\n- [Key Applications](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#key-applications)\n  - [PyCharm](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#pycharm)\n  - [VSCode](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#vscode)\n  - [RStudio](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#rstudio)\n  - [Orbstack](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#orbstack)\n- [Handy Applications](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#handy-applications)\n  - [Itsycal](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#itsycal)\n  - [Raycast](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#raycast)\n  - [Maccy](https://github.com/nikdata/setting-up-my-mac?tab=readme-ov-file#maccy)\n\n### Homebrew\n\n[Homebrew](https://brew.sh) is a package manager for both Linux \u0026 macOS. Think of Homebrew like an app store, but primarily run through the command line. You can find thousands of applications on homebrew - including Linux-like libraries for macOS.\n\nHomebrew can be installed by running the following line in macOS Terminal app:\n\n``` shell\n/bin/bash -c \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\"\n```\nYou may be required to install Command Line Tools, but Homebrew can install it for automatically.\n\n### Make Terminal Better\n\nUsing the command line is important if you're a developer. The Terminal app in macOS is good.\n\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://i.imgflip.com/4tvuhv.jpg\" width=300 \u003e\u003c/p\u003e\n\nBut it can be better!\n\n#### iTerm2 - the Better Terminal app\n[iTerm2](https://iterm2.com) is a command line application emulator that can really make things better for you. For example, you can have tiled windows within 1 window. Now you too can be like one of those cool developers in sci-fi movies!\n\nYou can install iTerm2 by downloading from their [website](https://iterm2.com) or use the following command in the Terminal app:\n\n``` shell\nbrew install --cask iterm2\n```\n\n#### ZSH\nZSH is Z shell and it's the 'default' for macOS. You'll want to install zsh. Trust me. And now you can use iTerm2!\n\n``` shell\nbrew install zsh\n```\n\n#### Oh-My-Zsh\n[Oh-My-ZSH](https://ohmyz.sh) is a framework for managing zsh configuration. Why do you want it? It's a powerful tool to help make things easier while using the z-shell.\n\nYou can install Oh-My-Zsh using iTerm2:\n\n``` shell\nsh -c \"$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)\"\n```\n\n#### Powerlevel10k\n\nOne of the cool things with using Oh-my-Zsh is themeing it. I like using the [Powerlevel10K](https://github.com/romkatv/powerlevel10k) theme.\n\nThese are the [instructions](https://github.com/romkatv/powerlevel10k?tab=readme-ov-file#oh-my-zsh) for installing it on zsh.\n\nNOTE: This project is probably not going to last forever. I may end up switching to [starship](https://starship.rs)\n\nThe instructions/site I've linked do a great job of walking through the configuration of Powerlevel10k. It's pretty easy to configure and you pretty much only have to do it once.\n\n### Git\n\nThere's a very good chance that the current macOS version you have on your new Mac is using an outdated version of git. Git is the \"soul\" behind GitHub and it's a very powerful tool for code version tracking. It doesn't matter if you use GitLab, BitBucket, or whatever - chances are git is the tool behind them.\n\nInstall the latest version of git:\n\n``` shell\nbrew install git\n```\n\n#### Configure git\nYou can also configure git to use a default user name \u0026 email:\n\n``` shell\ngit config --global user.name \"\u003cany name\u003e\"\ngit config --global user.email \"\u003cany.email@example.com\u003e\"\n```\n\nYou can also set up the default branch. I like to use main.\n\n``` shell\ngit config --global init.defaultBranch main\n```\n\nI also like to use nano instead of vim:\n\n``` shell\ngit config --global core.editor \"nano\"\n```\n\n### GitHub \u0026 SSH Key\n\nA more secure way to interact with GitHub is to use SSH tokens. This prevents your username \u0026 password from being used and if your token ever becomes public, just delete and create a new one.\n\nInstructions can be found [here](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent)\n\n#### Create a .ssh folder\n\nNavigate to your home folder\n\n``` shell\ncd ~\n```\n\nNow create the .ssh folder\n\n``` shell\nmkdir .ssh\n```\n\nCreate a key (replace with your email address):\n\n``` shell\nssh-keygen -t ed25519 -C \"your_email@example.com\"\n```\n\n#### Add to GitHub\n\nYou can add your new key using these [instructions](https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account)\n\n### Python\n\nInstall the latest version of Python\n\n``` shell\nbrew install python\n```\n\nInstall uv (a faster way to install Python libraries as compared to pip)\n\n``` shell\n# On macOS and Linux.\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\nInstall [micromamba](https://mamba.readthedocs.io/en/latest/installation/micromamba-installation.html):\n\n``` shell\nbrew install micromamba\n```\n\nDon't bother with mamba, conda, etc. Micromamba is small, efficient, and fast.\n\n### R\n\nAlways install R from [CRAN's website](https://cran.r-project.org).\n\n### Key Applications\n\n#### PyCharm\n\nDownload \u0026 install PyCharm [here](https://www.jetbrains.com/pycharm/).\n\n#### VSCode\n\nDownload from [https://code.visualstudio.com/](https://code.visualstudio.com/)\n\n#### RStudio\n\nI know that [Positron](https://positron.posit.co) is the new IDE that Posit is coming out with. It's still not ready for full production use (as of 17 Feb 2025). Almost there!\n\nFor now, I still use [RStudio](https://posit.co/download/rstudio-desktop/).\n\n#### Docker \u0026 Orbstack\n\n[Orbstack](https://orbstack.dev) is a better version of Docker Desktop. It's more efficient and faster. And if you're on a laptop, Orbstack is just the right tool to use.\n\n### Handy Applications\n\n#### Itsycal\n\n[Itsycal](https://www.mowglii.com/itsycal/) is a neat little calendar that can stay in your menu bar at the top.\n\n``` shell\nbrew install --cask itsycal\n```\n\n#### Raycast\n\n[Raycast](https://www.raycast.com) is powerful replacement for spotlight\n\n``` shell\nbrew install --cask raycast\n```\n\n#### maccy\n\n[Maccy](https://maccy.app) is a clipboard history tool.\n\n``` shell\nbrew install --cask maccy\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikdata%2Fsetting-up-my-mac","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnikdata%2Fsetting-up-my-mac","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnikdata%2Fsetting-up-my-mac/lists"}