🍎 Auto setup for developing environment on macOS

Desktop environment preference for macOS Sonoma (Apple Silicon and Intel supported)
macOS Sonoma (Apple Silicon / intel 両対応) 向けの作業環境セットアップスクリプト

Overview

Fully automate the installation and settings of the app to make it easier to create an environment when you buy a new Mac.
新しい Mac を購入した際に、より手軽に環境構築するために、 アプリのインストールや設定を全自動化します。

Usage

First, give the terminal "full disk access" privileges by seeing the following URL.
最初に、以下の URL を参考にして、 ターミナルにフルディスクアクセス権限を与えてください。

https://discussions.apple.com/thread/251260652

Then just run the following command! You can also start it by double-clicking from the Finder app.
次に以下のコマンドを実行するだけです！ Finder からダブルクリックで起動しても構いません。

./setup

The script used to use the Ansible, but now it didn't because it's a bit too lengthy.
かつては Ansible を使用していましたが、 少々冗長すぎるため今は使用していません。

Details

Apps install

When the interactive operation is required, implemented voice notifications as much as possible.
対話的な操作が必要になる場合、 できる限り音声での通知をするように実装しています。

Unless otherwise specified, as a general rule, install via Homebrew or Cask.
特筆なき場合、原則として Homebrew または Cask 経由でインストールします。

CLI Apps

note	description
!	DEPENDENCIES: Removing this app may cause this setup to stop working correctly.
-A	without Apple Silicon Processor

Benchmark

• cloc
• fastfetch

Configuration tools

• chezmoi

Convert tools for Media binary

• FFmpeg
• ImageMagick
• libvips

Convert tools for Texts

• groff
• jq
• nkf

Database

• SQLite

Development

• ANTLR
• asdf
  • plugin: asdf-dotnet
    • .NET (via asdf-dotnet)
      • v6.0
      • v7.0
      • v8.0
  • plugin: asdf-nodejs (via asdf)
    • Node.js (via asdf-nodejs)
      • v18 LTS Hydrogen
      • v20 LTS Iron
      • v21
      • v22
  • plugin: asdf-python (via asdf)
    • Python (via asdf-python)
      • v2
      • v3 (via deep dependencies of the Homebrew packages: e.g., AWS CLI, graphviz, and others)
• CMake
• ! Command Line Tools for Xcode (via xcode-select CLI)
• ! gawk: GNU awk utility
• ! GCC: the GNU Compiler Collection
• Microsoft .NET SDK
• lv2: LADSPA v2
• (-A) Mono
• ! Rust
• shellcheck
• vrc-get

Documentation

• Graphviz
• mdp
• pandoc
• PlantUML
• wkhtmltopdf

Files management

• bat
• broot
• exa
• fzf
• myside
• p7zip
• rename
• rsync

Packages manager

• Homebrew (directly install)
• SteamCMD

Runtime

• AdoptOpenJDK
• Apple Rosetta 2 via Apple Software Update

Testing

• Microsoft PICT
• mkcert
• Mozilla Network Security Services
• ngrok

Version control system

• Apache Subversion
• Gist
• ! Git
  • ! Git Large File Storage
  • git-delta: A viewer for git and diff output
  • git-vrc (via cargo)
• GitHub CLI
• GLab: GitLab CLI tool

Remote

• awscli
• aws-nuke
• AWS SAM CLI
• ! curl
• ! GNU wget
• Mosh
• nmap
• OpenVPN
• inetutils: GNU network utilities
• Tor

Shell

• bats-core
• lporg
• Microsoft PowerShell
• Prezto (via Git)
  • Powerlevel10k (via Prezto)
• The Fuck
• tmux
• ! zsh-completions

Signature

• ! GnuPG: The GNU Privacy Guard
• ! PINEntry for Mac
• ! Unbound

System

• ! Coreutils: GNU Core Utilities
• gotop
• htop
• Mackup
• ! Proctools: pgrep, pkill and pfind for Darwin

Text Browsing

• cheat
• links
• tldr pages

Text editors

• GNU Nano
• Neovim
• Vim

Virtualizations

• act
• GitLab Runner
• Parallels Virtualization SDK
• Vagrant
  • plugins (via Vagrant)
    • (-A) vagrant-disksize
    • Vagrant Parallels Provider
    • Vagrant Reload Provisioner
    • (-A) vagrant-vbguest

Others

• ! mas-cli
• Nyancat CLI

Desktop Apps

Apps that exist in the Mac App Store are temporarily not installed by this script. It's because the installation is unstable and very slow.
Mac App Store からインストール可能なアプリは、 このスクリプトでは暫定的にインストールしないようにしています。 インストールが不安定かつ非常に低速となるためです。

note	description
!	DEPENDENCIES: Removing this app may cause this setup to stop working correctly.
-A	without Apple Silicon Processor

3D Modeling

• Blender
• FreeCAD

Audios, Videos, and Broadcasting

• Apple GarageBand (via Mac App Store)
• Apple iMovie (via Mac App Store)
• iZotope Product Portal
• OBS Studio
• Restream Chat
• Rogue Amoeba Audio Hijack
• Rogue Amoeba Loopback
• Schism Tracker
• Sonic Visualiser

Authentication

• (-A) Authy Desktop
• (-A) Keybase

Benchmark

• Blackmagic Disk Speed Test (via Mac App Store)
• MAXON Cinebench (via Mac App Store)

Cloud storages

• Adobe Creative Cloud
• Microsoft OneDrive
• OmniPresence

Development

• Android Studio
• Apple Developer (via Mac App Store)
• ! Apple Xcode (via Mac App Store)
• Apple TestFlight (via Mac App Store)
• React Native Debugger
• Unity Hub
  • Unity version 2019.4.31f1 (via Unity Hub)
  • Unity version 2022.3.6f1 (via Unity Hub)
  • with the common modules
    • Module: Android Build Support
    • Module: Windows Build Support (Mono)
    • Module: Documentation
    • Module: Language Pack (Japanese)
• VCC for mac

Devices

• scrcpy
• Canon Satera MF Printer driver
• (-A) Haptic Touch Bar (Troublesome to determine whether or not the TouchBar is present)
• Karabiner-Elements
• logicool G Hub
• Raspberry Pi Imager
• X-Mirage

Documents and Office apps

• Amazon Kindle (via Mac App Store)
• Manta (via Mac App Store)
• Apple Keynote (via Mac App Store)
• Apple Numbers (via Mac App Store)
• Apple Pages (via Mac App Store)
• Microsoft Excel (via Mac App Store)
• Microsoft OneNote (via Mac App Store)
• Microsoft PowerPoint (via Mac App Store)
• Microsoft Word (via Mac App Store)

Games

• Human Resource Machine (via Mac App Store)
• Minecraft Java Edition
• Steam

Memos and Tasks

• (-A) Boost Note
• Grammarly
• Microsoft To Do (via Mac App Store)
• Notion
• OmniFocus (via Mac App Store)

Messaging and Socials

• Discord
• Facebook Messenger (via Mac App Store)
• LINE (via Mac App Store)
• Microsoft Skype
• Microsoft Teams
• Slack (via Mac App Store)
• Twitter (via Mac App Store)
• Zoom

Remote

• Amazon Workspaces
• Apple Remote Desktop (via Mac App Store)
• Microsoft Remote Desktop (via Mac App Store)
• OpenVPN Connect
• Real VNC Viewer
• SwitchHosts
• TeamViewer

Terminal

• term
• terminal-notifier

Text editors

• Cursor
• Sublime Text
• Visual Studio Code

Virtualizations

• DOSBox-X
• Docker Desktop
• Parallels Desktop
• (-A) Oracle VM Virtualbox + Extension Pack

Web browsers

• Google Chrome
• (-A) Chromium
• Insomnia
• Mozilla Firefox ESR
• Tor Browser
• Some extensions for Apple Safari (via Mac App Store)
  • Grammarly for Safari

Fonts

note	description
!	DEPENDENCIES: Removing this app may cause this setup to stop working correctly.

• ! 白源: HackGen Nerd
• IBM Plex
• Lato
• ! Meslo LG

Install the upgrade script

Install a script to upgrade the installed app with just one command.
ひとつのコマンドだけで、 インストールしたアプリをアップグレードするスクリプトをインストールします。

Usage & Details

~/bin/update

• Upgrade the apps installed via the Homebrew
• Upgrade the plugins of Vagrant
• Upgrade the Docker images
• Upgrade the Prezto
• Upgrade the asdf (.NET, Node.js, and Python)

Pulls some docker images

list

Image	Tag
hello-world	latest
alpine	latest
busybox	latest
debian	latest
ubuntu	latest
docker	dind, git, latest
node	18, 18-alpine, 18-slim, 20, 20-alpine, 20-slim, 21, 21-alpine, 21-slim, 22, 22-alpine, 22-slim
gitlab/gitlab-runner	latest
ghcr.io/catthehacker/ubuntu	act-22.04, act-latest, ubuntu:full-20.04, ubuntu:full-latest

Initialize for Zsh / Prezto / Powerlevel10k

The script creates a symbolic link to the Prezto default profile. Also, add a definition so that you can scan under the ~/.zsh.d folder when starting the interactive shell.
セットアップ スクリプトは Prezto 既定のプロファイルへ、 シンボリックリンクを作成します。同時に、対話シェル開始時に ~/.zsh.d フォルダ配下をスキャンできるよう定義を追加しています。

Initialize for web-frontend development environment

The script creates and installs a local CA in the system root store, and generates locally-trusted certificates using the mkcert.
セットアップ スクリプトは mkcert を使用して、システムルートストアにローカル CA を作成してインストールし、ローカルで信頼できる証明書を生成します。

Also, by starting Firefox in this process, if the root store does not exist, it will be initialized.
また、この工程で Firefox を起動することにより、 ルートストアが存在しない場合、初期化します。

Customization of macOS desktop

See: https://macos-defaults.com/

See also

• Depended repository: kurone-kito/dotfiles

Playground

Using Vagrant and Virtualbox, you can try out the script in a virtual environment.
Vagrant と Virtualbox を使用して、仮想環境でスクリプトを試すことができます。

vagrant up

The script can also be attempted via the test script, but this script is not maintained and is deprecated.
このスクリプトを test スクリプト経由でも試行可能ですが、 このスクリプトはメンテナンスしていないので非推奨です。

Contributing

Welcome to contribute to this repository! For more details, please refer to CONTRIBUTING.md.

License

MIT