:toc: macro :toclevels: 5 :figure-caption!:

= macOS Configuration

Shell scripts for customized macOS machine setup and configuration.

This project provides a highly opinionated default configuration built upon the link:https://www.alchemists.io/projects/mac_os[macOS] project. Should the configuration provided by this project not be to your liking, feel free to fork and customize for your specific needs.

toc::[]

== Features

Due to the amount of tooling used, the following features are broken down into subsections for easier navigation.

=== Homebrew Formulas

Installs the following link:https://brew.sh[formulas]:

• link:https://asciinema.org[asciinema]
• link:https://www.gnu.org/software/bash[Bash]
• link:http://bash-completion.alioth.debian.org[Bash Completion]
• link:https://github.com/sharkdp/bat[Bat]
• link:https://github.com/toy/blueutil[blueutil]
• link:https://github.com/schollz/croc[croc]
• link:https://crystal-lang.org[Crystal]
• link:http://ctags.sourceforge.net[CTags]
• link:https://dagger.io[Dagger]
• link:https://direnv.net[direnv]
• link:https://github.com/wagoodman/dive[Dive]
• link:https://dns.lookup.dog[dog]
• link:https://github.com/muesli/duf[duf]
• link:http://duti.org[duti]
• link:https://eradman.com/entrproject[Entr]
• link:https://the.exa.website[Exa]
• link:https://exiftool.org/index.html[ExifTool]
• link:https://github.com/sharkdp/fd[fd]
• link:https://www.xiph.org/flac[FLAC]
• link:https://github.com/tako8ki/frum[Frum]
• link:https://github.com/Schniz/fnm[Fast Node Manager]
• link:https://github.com/junegunn/fzf[FZF]
• link:https://git-scm.com[Git]
• link:https://github.com/dandavison/delta[Git Delta]
• link:https://github.com/newren/git-filter-repo[Git Filter Repo]
• link:https://github.com/github/git-sizer[Git Sizer]
• link:https://www.gnupg.org[GPG]
• link:https://github.com/orf/gping[gping]
• link:http://www.graphicsmagick.org[Graphics Magick]
• link:https://www.graphviz.org[Graphviz]
• link:https://github.com/sharkdp/hexyl[hexyl]
• link:http://www.andre-simon.de/doku/highlight/en/highlight.php[Highlight]
• link:https://github.com/LuRsT/hr[hr]
• link:https://github.com/mgdm/htmlq[htmlq]
• link:https://hisham.hm/htop[htop]
• link:https://github.com/jkbrzt/httpie[HTTPie]
• link:https://github.com/reorx/httpstat[HTTP Stat]
• link:https://github.com/sharkdp/hyperfine[Hyperfine]
• link:https://github.com/koct9i/ioping[Ioping]
• link:https://stedolan.github.io/jq[jq]
• link:https://lnav.org[lnav]
• link:https://github.com/CISOfy/lynis[Lynis]
• link:https://github.com/mas-cli/mas[Mac App Store]
• link:https://jedisct1.github.io/minisign[Minisign]
• link:https://mitmproxy.org[mitmproxy]
• link:https://dev.yorhel.nl/ncdu[NCurses Disk Usage]
• link:https://nodejs.org[Node.js]
• link:https://github.com/variadico/noti[Noti]
• link:https://github.com/nushell/nushell[Nushell]
• link:https://github.com/hatoo/oha[Oha]
• link:https://www.openssh.com[OpenSSH]
• link:https://openssl.org[OpenSSL]
• link:https://github.com/DarthSim/overmind[Overmind]
• link:https://pandoc.org[Pandoc]
• link:https://savannah.gnu.org/projects/parallel[Parallel]
• link:https://github.com/sharkdp/pastel[Pastel]
• link:https://www.pgcli.com[pgcli]
• link:https://www.zlib.net/pigz[Pigz]
• link:https://github.com/GPGTools/pinentry[Pinentry]
• link:https://www.postgresql.org[PostgreSQL]
• link:https://github.com/dalance/procs[Procs]
• link:https://tiswww.case.edu/php/chet/readline/rltop.html[Readline]
• link:http://redis.io[Redis]
• link:https://github.com/BurntSushi/ripgrep[ripgrep]
• link:https://github.com/koalaman/shellcheck[ShellCheck]
• link:https://www.joedog.org/siege-home[Siege]
• link:https://www.bernhard-baehr.de[Sleepwatcher]
• link:https://www.tarsnap.com[Tarsnap]
• link:https://github.com/dbrgn/tealdeer[Tealdeer]
• link:https://www.terraform.io[Terraform]
• link:https://github.com/ggreer/the_silver_searcher[The Silver Surfer]
• link:https://github.com/tmux/tmux/wiki[tmux]
• link:https://github.com/XAMPPRocky/tokei[Tokie]
• link:https://github.com/sachaos/viddy[Viddy]
• link:https://www.vim.org[Vim]
• link:https://gitlab.com/procps-ng/procps[Watch]
• link:https://github.com/vi/websocat[Websocat]
• link:https://github.com/BurntSushi/xsv[xsv]
• link:https://github.com/mptre/yank[Yank]
• link:https://developers.yubico.com/yubikey-manager[YubiKey Manager CLI]
• link:https://github.com/ajeetdsouza/zoxide[Zoxide]

=== Homebrew Casks

Installs the following link:https://brew.sh[casks]:

• link:https://www.alfredapp.com[Alfred]
• link:https://freemacsoft.net/appcleaner[App Cleaner]
• link:https://www.rogueamoeba.com/audiohijack[Audio Hijack]
• link:https://www.balena.io/etcher[Balena Etcher]
• link:https://www.macbartender.com[Bartender]
• link:https://bombich.com[Carbon Copy Cloner]
• link:https://getcleanshot.com[CleanShot]
• link:https://clipgrab.org[ClipGrab]
• link:https://kapeli.com/dash[Dash]
• link:https://discord.com[Discord]
• link:https://www.getdoxie.com[Doxie]
• link:https://www.dropbox.com[Dropbox]
• link:https://www.mozilla.com/en-US/firefox[Firefox]
• link:https://www.rogueamoeba.com/fission[Fission]
• link:https://www.google.com/chrome[Google Chrome]
• link:https://www.noodlesoft.com[Hazel]
• link:https://iina.io[IINA]
• link:http://imageoptim.pornel.net[ImageOptim]
• link:https://bjango.com/mac/istatmenus[iStat Menus]
• link:https://www.iterm2.com[iTerm2]
• link:https://www.kaleidoscopeapp.com/ksdiff2[ksdiff]
• link:https://logseq.com[Logseq]
• link:https://mockuuups.studio[Mockuuups Studio]
• link:https://muzzleapp.com[Muzzle]
• link:https://netnewswire.com[NewNewsWire]
• link:https://ngrok.com[Ngrok]
• link:https://numi.app[Numi]
• link:https://obsidian.md[Obsidian]
• link:https://www.openoffice.org[OpenOffice]
• link:https://www.owasp.org/index.php/OWASP_Zed_Attack_Proxy_Project[OWASP Zed Attack Proxy (ZAP)]
• link:https://cocoatech.com[Path Finder]
• link:https://paw.cloud[Paw]
• link:https://www.pgadmin.org[pgAdmin]
• link:https://superhighfives.com/pika[Pika]
• link:https://getpixelsnap.com[PixelSnap]
• link:https://protonvpn.com[ProtonVPN]
• link:https://manytricks.com/resolutionator[Resolutionator]
• link:https://flyingmeat.com/retrobatch[Retrobatch]
• link:https://signal.org[Signal]
• link:https://www.sublimetext.com[Sublime Text]
• link:https://panic.com/transmit[Transmit]
• link:https://twist.com[Twist]
• link:https://www.sparklabs.com/viscosity[Viscosity]
• link:https://code.visualstudio.com[Visual Studio Code]

=== App Store Applications

Installs the following link:https://www.apple.com/app-store[App Store] applications:

• link:https://1password.com[1Password]
• link:https://secure.flyingmeat.com/acorn[Acorn]
• link:https://itunes.apple.com/us/app/aquapath/id424425207[AquaPath]
• link:https://daisydiskapp.com[DaisyDisk]
• link:https://www.apple.com/mac/garageband[GarageBand]
• link:https://handmirror.app[Hand Mirror]
• link:https://www.apple.com/imovie[iMovie]
• link:https://manytricks.com/keycodes[Key Codes]
• link:https://manytricks.com/keymou[Keymou]
• link:https://www.apple.com/keynote[Keynote]
• link:http://www.amazon.com/gp/feature.html?docId=1000464931[Kindle]
• link:https://manytricks.com/leech[Leech]
• link:http://limechat.net/mac[LimeChat]
• link:https://marked2app.com[Marked 2]
• link:http://getmedis.com[Medis]
• link:https://trymeeter.com[Meeter]
• link:https://mindnode.com[MindNode]
• link:https://nothirst.com[MoneyWell]
• link:https://manytricks.com/moom[Moom]
• link:https://manytricks.com/namemangler[Name Mangler]
• link:https://www.apple.com/numbers[Numbers]
• link:https://www.omnigroup.com/omnifocus[OmniFocus]
• link:https://www.apple.com/pages[Pages]
• link:https://krillapps.com/patterns[Patterns]
• link:https://software.charliemonroe.net/permute[Permute]
• link:https://www.pixelmator.com[Pixelmator]
• link:https://apps.apple.com/app/apple-store/id1494948845[Paletter]
• link:https://primitive.lol[Primitive]
• link:https://apps.apple.com/gb/app/sequence-diagram/id1195426709[Sequence Diagram]
• link:https://shapesapp.com[Shapes]
• link:https://mizage.com/shush[Shush]
• link:https://slack.com[Slack]
• link:https://www.adriangranados.com[WiFi Explorer]

=== Non-App Store Applications

Installs the following macOS applications which are not located in the App Store:

• link:https://elm-lang.org[Elm]
• link:https://www.docker.com[Docker]
• link:https://www.kaleidoscopeapp.com[Kaleidoscope]
• link:https://www.sonos.com[Sonos]

=== Application Extensions

Installs the following extensions to existing applications:

• link:https://github.com/tpope/vim-bundler[Vim Bundler]
• link:https://github.com/tpope/vim-commentary[Vim Commentary]
• link:https://github.com/tpope/vim-fugitive[Vim Fugitive]
• link:https://github.com/airblade/vim-gitgutter[Vim Git Gutter]
• link:https://github.com/tpope/vim-pathogen[Vim Pathogen]
• link:https://github.com/tpope/vim-projectionist[Vim Projectionist]
• link:https://github.com/tpope/vim-rails[Vim Rails]
• link:https://github.com/vim-ruby/vim-ruby[Vim Ruby]
• link:https://github.com/AndrewRadev/splitjoin.vim[Vim Splitjoin]
• link:https://github.com/kana/vim-textobj-user[Vim Text Object User]
• link:https://github.com/tpope/vim-unimpaired[Vim Unimpaired]

=== Node Packages

Installs the following link:https://nodejs.org[Node] link:https://www.npmjs.com[packages]:

• link:https://github.com/tomekwi/elm-live[Elm Live]
• link:https://github.com/elm-explorations/test[Elm Test]

=== Ruby Gems

Installs the following link:https://www.ruby-lang.org[Ruby] link:https://rubygems.org[gems]:

• link:https://github.com/amazing-print/amazing_print[Amazing Print]
• link:https://asciidoctor.org[ASCII Doctor]
• link:https://github.com/evanphx/benchmark-ips[Benchmark IPS]
• link:https://github.com/jmmastey/bundler-stats[Bundler Stats]
• link:https://github.com/mattbrictson/bundleup[BundleUp]
• link:https://www.alchemists.io/projects/caliber[Caliber]
• link:https://github.com/ruby/debug[Debug]
• link:https://www.alchemists.io/projects/flacsmith[Flacsmith]
• link:https://www.alchemists.io/projects/gemsmith[Gemsmith]
• link:https://www.alchemists.io/projects/git-lint[Git Lint]
• link:https://hanamirb.org[Hanami]
• link:https://github.com/jaredbeck/libyear-bundler[Libyear (Bundler)]
• link:https://www.alchemists.io/projects/pennyworth[Pennyworth]
• link:https://github.com/joonty/pessimize[Pessimize]
• link:https://www.alchemists.io/projects/pragmater[Pragmater]
• link:https://rubyonrails.org[Ruby on Rails]
• link:https://github.com/ruby/rake[Rake]
• link:https://github.com/troessner/reek[Reek]
• link:https://rspec.info[RSpec]
• link:https://www.alchemists.io/projects/rubysmith[Rubysmith]
• link:https://solargraph.org/guides[Solargraph]
• link:https://www.alchemists.io/projects/sublime_text_kit[Sublime Text Kit]
• link:https://github.com/red-data-tools/YouPlot[YouPlot]

=== Rust Crates

Installs the following link:https://www.rust-lang.org[Rust] link:https://crates.io[crates]:

• link:https://jless.io[jless]
• link:https://github.com/Aloxaf/silicon[Silicon]

== Requirements

. Apple Silicon hardware. . link:https://www.alchemists.io/projects/mac_os[macOS] . link:https://developer.apple.com/xcode[Xcode]

== Setup

To install, run:

[source,bash]

git clone https://github.com/bkuhlmann/mac_os-config.git cd mac_os-config git checkout 22.4.0

== Usage

The following will walk you through the steps of installing/re-installing your machine.

=== Pre-Install

Ensure you have the following in place for your Silicon machine:

. Ensure a backup of your Apple, NAS, backup image, and Dropbox credentials are available. . Ensure a recent backup of your machine exists and works properly. . Ensure link:https://support.apple.com/en-us/HT208198[Startup Security Utility] is disabled. .. Turn off your machine. .. Start your machine by pressing and holding the POWER button until you see startup options being loaded. .. Select Utilities → Startup Security Utility from the main menu. .. Select Reduced Security. .. Quit the utility and restart the machine.

=== Install

. Create a link:https://www.alchemists.io/projects/mac_os/#_boot_disk[macOS Boot Disk] and follow instructions. . Ensure latest software updates are applied per link:https://www.alchemists.io/projects/mac_os/#_requirements[macOS Requirements]. . Ensure Xcode is installed per link:https://www.alchemists.io/projects/mac_os/#_requirements[macOS Requirements]. . Run link:https://www.alchemists.io/projects/mac_os#_usage[macOS Install] and follow all prompts.

=== Post-Install

The following are additional steps, not easily automated, that are worth completing after the install scripts have completed:

• System Preferences ** Apple ID *** Configure iCloud. *** Enable Find My Mac. ** Security & Privacy *** General **** Require password immediately after sleep or screen saver begins. **** Enable message when screen is locked. Example: +<url> | <email> | <phone>+. **** Allow your Apple Watch to unlock your Mac. *** FileVault **** Enable FileVault and save the recovery key in a secure location (i.e. 1Password). *** Firewall **** Enable. **** Automatically allow signed software. **** Enable stealth mode. ** Internet Accounts *** Add all accounts. ** Touch ID *** Rename fingerprint. ** Keyboard *** Keyboard **** Slide Key Repeat to Fast (max). **** Slide Delay Until Repeat to Short (max). *** Shortcuts **** Select Launchpad and Dock and uncheck Turn Dock Hiding On/Off. **** Select Mission Control and assign CONTROL + OPTION + COMMAND + N to Show Notification Center. **** Select Screenshots and uncheck all boxes. **** Select Spotlight and uncheck all boxes. ** Desktop and Screen Saver *** Select Desktop, click +, and choose custom image. *** Select Screen Saver, select Message, enter custom message, start after 10 minutes, and check show with clock. ** Bluetooth *** Reconnect keyboard, mouse, and earbuds. ** Network *** Configure Wi-Fi. ** Printers & Scanners *** Add printer/scanner. ** Users & Groups *** Update avatar image. *** Remove unused login items. *** Disable guest account. ** Wallet and Apple Pay *** Reenable all accounts and assign default card. ** Sound *** Sound Effects **** Uncheck Play sound on startup. **** Uncheck Play user interface sound effects. *** Battery **** Click on Battery and uncheck Show battery status in menu bar. **** Click on Power Adapter and check Prevent computer from sleeping automatically when the display is off. ** Notifications *** Do Not Disturb **** Enable Do Not Disturb from 9pm to 7am. **** Enable When display is sleeping. **** Enable When screen is locked. **** Enable When mirroring. **** Disable Allow calls from everyone. **** Enable allow repeated calls. *** Applications **** Select Banners for all apps. **** Disable Show notifications on lock screen. **** Disable Play sounds for notifications.
• iStat Menus ** Double click, within the Applications folder, to install as a system preference.
• Carbon Copy Cloner ** Rename old backup, create new backup, and set frequency schedule.

=== Keyboard Shortcuts

Several applications provide global hotkey support. These are the associations I use (which are also captured in the +restore.bom+ as well):

• COMMAND + SPACE (hold): Siri (open)
• COMMAND + SPACE: Spotlight (open)
• link:https://www.alchemists.io/articles/clean_shot/#_shortcuts[CleanShot] - See article for details.
• CONTROL + OPTION + COMMAND + b: Bartender (hidden menu toggle)
• CONTROL + OPTION + COMMAND + c: Pika (copy color)
• CONTROL + OPTION + COMMAND + d: Alfred Define (use OPTION to open Dictionary)
• CONTROL + OPTION + COMMAND + h: Alfred Highlight Syntax
• CONTROL + OPTION + COMMAND + k: Keymou (cursor highlight show/hide)
• CONTROL + OPTION + COMMAND + m: Moom (show/hide)
• CONTROL + OPTION + COMMAND + n: Notification Center (show/hide)
• CONTROL + OPTION + COMMAND + o: Alfred Open URL in default browser
• link:https://www.alchemists.io/articles/pixel_snap/#_shortcuts[PixelSnap] - See article for details.
• CONTROL + OPTION + COMMAND + r: Resolutionator (selector)
• CONTROL + OPTION + COMMAND + t: Alfred Large Type
• CONTROL + OPTION + COMMAND + w: Mission Control
• CONTROL + OPTION + COMMAND + ←: Keymou (move cursor left)
• CONTROL + OPTION + COMMAND + ↑: Keymou (move cursor up)
• CONTROL + OPTION + COMMAND + →: Keymou (move cursor right)
• CONTROL + OPTION + COMMAND + ↓: Keymou (move cursor down)
• CONTROL + OPTION + COMMAND + ENTER: Keymou (move cursor by division)
• CONTROL + OPTION + SPACE: OmniFocus (quick entry)
• OPTION + SPACE: Alfred (open)

=== Newsyslog

Native to macOS, link:https://www.freebsd.org/cgi/man.cgi?newsyslog.conf(5)[newsyslog] can be used to configure system-wide log rotation across multiple projects. It’s a good recommendation to set this up so that disk space is carefully maintained. Here’s how to configure it for your system, start by creating a configuration for your projects in the +/etc/newsyslog.d+ directory. In my case, I use the following configurations:

• +/etc/newsyslog.d/alchemists.conf+

....

logfilename [owner:group] mode count size when flags

/Users/bkuhlmann/Dropbox/Development/Work/**/log/*.log 644 2 5120 * GJN ....

• +/etc/newsyslog.d/homebrew.conf+

....

logfilename [owner:group] mode count size when flags

/usr/local/var/log/**/*.log 644 2 5120 * GJN ....

These configurations ensure that logs are rotated every 5MB (5120KB). In order to test that these configurations are valid, run:

.... sudo newsyslog -nvv ....

If you don’t see any errors in the output, then your configuration settings are correct.

The last thing to do is to add a launch configuration to ensure the log rotations happen at regularly scheduled intervals. To do this create the following file: +$HOME/Library/LaunchAgents/com.apple.newsyslog.plist+. It should have the following content:

[source,xml]

That’s it. System-wide log rotation is setup for your projects.

=== Customization

While this project’s configuration is opinionated and tailored for my setup, you can easily fork this project and customize it for your environment. Start by editing the files found in the +bin+ and +lib+ directories. Check out the link:https://www.alchemists.io/projects/mac_os/#_customization[macOS Customization Documentation] for further details.

TIP: The installer determines which applications/extensions to install as defined in the +settings.sh+ script. Applications defined with the "APP_NAME" suffix and extensions defined with the "EXTENSION_PATH" suffix inform the installer what to care about. Removing/commenting out these applications/extensions within the +settings.sh+ file will cause the installer to skip these applications/extensions.

== Development

To contribute, run:

[source,bash]

git clone https://github.com/bkuhlmann/mac_os-config.git cd mac_os-config

== link:https://www.alchemists.io/policies/license[License]

== link:https://www.alchemists.io/policies/security[Security]

== link:https://www.alchemists.io/policies/code_of_conduct[Code of Conduct]

== link:https://www.alchemists.io/policies/contributions[Contributions]

== link:https://www.alchemists.io/projects/mac_os-config/versions[Versions]

== link:https://www.alchemists.io/community[Community]

== Credits

Engineered by link:https://www.alchemists.io/team/brooke_kuhlmann[Brooke Kuhlmann].