{"id":23465380,"url":"https://github.com/sprak3000/setup-my-mac","last_synced_at":"2025-04-12T15:58:29.534Z","repository":{"id":28824945,"uuid":"32348401","full_name":"sprak3000/setup-my-mac","owner":"sprak3000","description":"Documentation, etc. for setting up a new Mac the way I like it.","archived":false,"fork":false,"pushed_at":"2022-12-22T03:00:04.000Z","size":33,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-04T14:04:43.539Z","etag":null,"topics":["hacktoberfest","osx","setup-macos","setup-osx","setup-tool","shell"],"latest_commit_sha":null,"homepage":"","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/sprak3000.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-03-16T19:39:44.000Z","updated_at":"2022-12-16T16:58:33.000Z","dependencies_parsed_at":"2023-01-14T09:40:37.926Z","dependency_job_id":null,"html_url":"https://github.com/sprak3000/setup-my-mac","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/sprak3000%2Fsetup-my-mac","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sprak3000%2Fsetup-my-mac/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sprak3000%2Fsetup-my-mac/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sprak3000%2Fsetup-my-mac/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sprak3000","download_url":"https://codeload.github.com/sprak3000/setup-my-mac/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248593011,"owners_count":21130306,"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":["hacktoberfest","osx","setup-macos","setup-osx","setup-tool","shell"],"created_at":"2024-12-24T11:24:49.475Z","updated_at":"2025-04-12T15:58:29.497Z","avatar_url":"https://github.com/sprak3000.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Setup My Mac\n\n- **Current Silicon Used:** Apple M1\n- **Current OS X Version Used:** `Ventura 13.1`\n\nThis repository holds my scripts, configuration files, notes, etc. for the rare occasion of setting up a new Mac for\nmyself. You will find in here:\n- My customizations to various system preferences\n- A script to \n  - Install a considerable amount of software I use\n  - Remind of software I need to install manually\n  - Setup my terminal theme\n  - Setup various dotfiles and configuration files I use via [chezmoi](https://www.chezmoi.io).\n\n## Initial Setup\n\nI follow these steps immediately after I first boot up a new Mac and go through the initial setup it presents:\n- Apply any system software updates.\n- Apply any App Store updates for pre-installed software.\n- Remove any unwanted applications from the dock.\n\n## System Preferences\n\nHere are the various customizations I make to the default system preferences.\n\n### General\n\n#### Date \u0026 Time\n\n- Turn on `24-hour time`. \n\n#### Language \u0026 Region\n \n- Set `First day of week` to `Sunday`.\n- Set `Date format` to `YYYY-MM-DD`.\n\n#### Sharing\n\n- `Local hostname` \u003e `Edit` and provide a better hostname.\n\n### Appearance \n\n- Set `Appearance` to `Dark`.\n\n### Desktop \u0026 Screen Saver\n\n- Add the `~/Pictures/wallpaper` directory to the `Folders` list and select it.\n- Check `Change picture` and set the drop-down to`Every 30 minutes`. Repeat for each monitor attached.\n- Check `Random Order`. Repeat for each monitor attached.\n\n### Desktop \u0026 Dock\n\n- Adjust `Size` to feel comfortable based on the screen size.\n- Set `Minimize windows using` to `Scale effect`.\n- Turn off `Automatically hide and show the Dock`.\n- Turn off `Show recent applications in Dock`.\n\n### Control Center\n\n- Set `Bluetooth` to `Show in Menu Bar`.\n- Set `Focus` to `Always Show in Menu Bar`.\n- Turn on `Battery \u003e Show Percentage`.\n- Set `Menu Bar Only \u003e Spotlight` to `Don't Show in Menu Bar`.\n- Set `Menu Bar Only \u003e Siri` to `Don't Show in Menu Bar`.\n- Turn on `Menu Bar Only \u003e Clock \u003e Clock Options \u003e Use a 24-hour clock`.\n\n### Siri \u0026 Spotlight\n\n- Turn off `Ask Siri`.\n- Uncheck all the items under `Spotlight`.\n\n### Wi-Fi\n\n- Click the `Details` button next to the desired network(s) and go to the `DNS` entry.\n  - Clear out any existing entries in `DNS Servers`.\n  - Add these DNS servers instead in this order:\n    - `1.1.1.1`\n    - `8.8.8.8`\n    - `8.8.4.4`\n  \n## Installation Script\n\n```\n./setup-my-mac.sh\n```\n\nThis `bash` script performs the following tasks in order:\n- Install [Homebrew](https://brew.sh/).\n- Use Homebrew to automatically install various software you would otherwise have to manually install (see `Brewfile` for list).\n- Setup fish shell to be the default shell.\n- Install the [oh-my-fish](https://github.com/oh-my-fish/oh-my-fish) package manager.\n- Use oh-my-fish to install any fish shell packages and the `gitstatus` theme.\n- Create the directories `~/github.com`, `~/Pictures/wallpapers`.\n- Remind me of any other software I need to manually download and install.\n- Use [chezmoi](https://www.chezmoi.io) to install dotfiles and configuration files.\n\nThe script endeavors to only perform a step if necessary. e.g., It attempts to detect already installed software to\nprevent trying to inst all it again.\n\n\n## What I Use\n\n### Utilities\n\n|                            Name                             | Description                                                                                                    |                                            Installation                                            |\n|:-----------------------------------------------------------:|----------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------:|\n|                [Homebrew](https://brew.sh/)                 | OS X package manager used to install software                                                                  | See latest instructions on homepage. `setup-my-mac.sh` has those instructions as of last check-in. |\n|         [wget](https://www.gnu.org/software/wget/)          | Utility for retrieving files via HTTPS, etc.                                                                   |                                              Homebrew                                              |\n|        [autojump](https://github.com/wting/autojump)        | Utility for quickly changing to previously visited directories                                                 |                                              Homebrew                                              |\n|    [youtube-dl](https://ytdl-org.github.io/youtube-dl/)     | Utility for downloading videos from YouTube and other streaming sites                                          |                                              Homebrew                                              |\n|       [ssh-copy-id](https://www.ssh.com/ssh/copy-id)        | Utility for installing SSH keys on a server                                                                    |                                              Homebrew                                              |\n|         [Jumpcut](https://github.com/snark/jumpcut)         | Clipboard manager                                                                                              |                                           Homebrew Cask                                            |\n| [Caffeine](https://intelliscapesolutions.com/apps/caffeine) | Prevents your Mac from automatically going to sleep                                                            |                                           Homebrew Cask                                            |\n|     [VeraCrypt](https://www.veracrypt.fr/en/Home.html)      | Disk encryption software                                                                                       |                                           Homebrew Cask                                            |\n|            [LastPass](https://www.lastpass.com/)            | Password manager                                                                                               |                                           Homebrew Cask                                            |\n|         [FileZilla](https://filezilla-project.org/)         | FTP client                                                                                                     |                                               Manual                                               |\n|              [f.lux](https://justgetflux.com/)              | Adjust the screen colors based on time of day                                                                  |                                           Homebrew Cask                                            |\n|       [MacVIM](https://macvim-dev.github.io/macvim/)        | Text editor                                                                                                    |                                           Homebrew Cask                                            |\n|                [xbar](https://xbarapp.com/)                 | Put the output of a script into your menu bar                                                                  |                                           Homebrew Cask                                            |\n|         [iCalBuddy](https://hasseg.org/icalBuddy/)          | Command-line utility that can be used to get lists of events and tasks/to-do's from the OS X calendar database |                                              Homebrew                                              |\n|           [rbenv](https://github.com/rbenv/rbenv)           | Manage installed versions of Ruby on your machine                                                              |                                              Homebrew                                              |\n|         [Hammerspoon](https://www.hammerspoon.org/)         | LUA based automation tool                                                                                      |                                           Homebrew Cask                                            |\n|              [chezmoi](https://www.chezmoi.io)              | Manage your dotfiles across multiple diverse machines, securely.                                               |                                              Homebrew                                              |\n\n### Alternative Terminals, Shells, Fonts\n\n|                           Name                            | Description                                                                            |                                            Installation                                            |\n|:---------------------------------------------------------:|----------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------:|\n|               [iTerm2](http://iterm2.com/)                | My preferred replacement for the OS X terminal program                                 |                                           Homebrew Cask                                            |\n|           [fish shell](https://fishshell.com/)            | My preferred shell these days                                                          |                                              Homebrew                                              |\n|  [oh-my-fish](https://github.com/oh-my-fish/oh-my-fish)   | Package manager for fish shell used to install themes and fish shell related utilities | See latest instructions on homepage. `setup-my-mac.sh` has those instructions as of last check-in. |\n| [JetBrains Mono Font](https://www.jetbrains.com/lp/mono/) | Programmer friendly font                                                               |                                           Homebrew Cask                                            |\n\n### Programming IDEs\n\n|                           Name                           | Description                                  | Installation |\n|:--------------------------------------------------------:|----------------------------------------------|:------------:|\n|     [PHPStorm](https://www.jetbrains.com/phpstorm/)      | JetBrains IDE for PHP development            |    Manual    |\n|         [GoLand](https://www.jetbrains.com/go/)          | JetBrains IDE for Go development             |    Manual    |\n|     [WebStorm](https://www.jetbrains.com/webstorm/)      | JetBrains IDE for JavaScript development     |    Manual    |\n|     [DataGrip](https://www.jetbrains.com/datagrip/)      | JetBrains IDE for SQL / database development |    Manual    |\n| [XCode](https://apps.apple.com/us/app/xcode/id497799835) | Apple development                            |  App Store   |\n\n### Web Browsers\n\n|                                     Name                                      | Description                                  | Installation  |\n|:-----------------------------------------------------------------------------:|----------------------------------------------|:-------------:|\n| [Firefox Developer Edition](https://www.mozilla.org/en-US/firefox/developer/) | Version of Firefox geared towards developers | Homebrew Cask |\n\n### Chat \u0026 Social Media\n\n|                Name                | Description    | Installation  |\n|:----------------------------------:|----------------|:-------------:|\n|    [Slack](https://slack.com/)     |                |   App Store   |\n|  [Discord](https://discord.com/)   |                | Homebrew Cask |\n| [Tweeten](https://tweetenapp.com/) | Twitter client | Homebrew Cask |\n\n### Entertainment\n\n|                                 Name                                 | Description                     | Installation  |\n|:--------------------------------------------------------------------:|---------------------------------|:-------------:|\n| [Battle.net](https://www.blizzard.com/en-us/apps/battle.net/desktop) | Blizzard gaming client          |    Manual     |\n|               [Steam](https://store.steampowered.com/)               | Platform for a variety of games | Homebrew Cask |\n|               [GOG Galaxy](https://www.gog.com/galaxy)               | Platform for older games        | Homebrew Cask |\n|            [VLC](https://www.videolan.org/vlc/index.html)            | Media player                    | Homebrew Cask |\n\n### Finance\n\n|                                     Name                                      | Description                      | Installation |\n|:-----------------------------------------------------------------------------:|----------------------------------|:------------:|\n| [Quicken Deluxe](https://www.quicken.com/personal-finance/quicken-deluxe-mac) | Keep track of financial accounts |    Manual    |\n|        [H\u0026R Block Tax Software](https://www.hrblock.com/tax-software/)        | Tax preparation \u0026 filing         |    Manual    |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsprak3000%2Fsetup-my-mac","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsprak3000%2Fsetup-my-mac","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsprak3000%2Fsetup-my-mac/lists"}