• Home
  • About
    • Moon photo

      Moon

      a development programmer, backend, Java.

    • Learn More
    • Github
  • Posts
    • All Posts
    • All Tags
  • Projects

macOS personal configuration

24 Mar 2026

Reading time ~3 minutes

macOS personal configuration

Recently, I accidentally deleted my macOS user files, which caused the Photos app to fail to open and become unrepairable. I had to reinstall macOS and back up my frequently used apps and configuration settings.

v2rayN

xattr -cr /Applications/v2rayN.app
#https://raw.githubusercontent.com/free18/v2ray/refs/heads/main/v.txt
#https://raw.githubusercontent.com/free18/v2ray/refs/heads/main/c.yaml

Rosetta 2

/usr/sbin/softwareupdate --install-rosetta --agree-to-license

Homebrew

Install Xcode CLT

xcode-select --install
xcode-select --help

Xcode CLT

Install Homebrew

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
echo 'export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"' >> ~/.zprofile
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"' >> ~/.zprofile
echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"' >> ~/.zprofile
source ~/.zprofile
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
brew help
brew --version
brew update
brew doctor
brew install jq
brew install shfmt
brew install shellcheck

git

git version
git config --global user.name "liubao"
git config --global user.email "paulluis.dev@gmail.com"
ssh-keygen -t rsa -b 4096 -C "paulluis.dev@gmail.com"
touch ~/.ssh/config
#Host alias
#  HostName localhost
#  User root
#  Port 22
#  IdentityFile ~/.ssh/id_rsa

JDK 8

java -version
#java version "1.8.0_441"
#Java(TM) SE Runtime Environment (build 1.8.0_441-b07)
#Java HotSpot(TM) 64-Bit Server VM (build 25.441-b07, mixed mode)

Maven

#!/usr/bin/env bash

bash --version 2>&1 | head -n 1

set -eo pipefail
SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
echo "$SCRIPT_DIR"

MVN_GZ_URL="https://archive.apache.org/dist/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz"

if ! [[ -f "$SCRIPT_DIR//apache-maven-3.6.3-bin.tar.gz" ]]; then
    echo "Downloading from $MVN_GZ_URL"
    curl -Lsfo "$SCRIPT_DIR/apache-maven-3.6.3-bin.tar.gz" $MVN_GZ_URL
fi
if ! [[ -f "$SCRIPT_DIR//apache-maven-3.6.3-bin.tar.gz" ]]; then
    echo "Please download manually."
    exit -1
fi

if ! [[ -d "/opt/apache-maven-3.6.3" ]]; then
    echo "Extracting..."
    sudo tar xzvf apache-maven-3.6.3-bin.tar.gz -C /opt
fi

echo "$PATH"
echo 'export PATH="$PATH:/opt/apache-maven-3.6.3/bin"' >> ~/.zshenv
source ~/.zshenv
mvn -v

Define a specified repository

sudo vim /opt/apache-maven-3.6.3/conf/settings.xml
#test
mvn help:system
#determine effective settings
mvn help:effective-settings

<mirror>
    <id>aliyunmaven</id>
    <mirrorOf>*</mirrorOf>
    <name>阿里云公共仓库</name>
    <url>https://maven.aliyun.com/repository/public</url>
</mirror>

Postman

Download Postman

JetBrains Toolbox

The last version to support both Community and Unified updates is Version 3.2

Windows App

Download Windows App from the Mac App Store.

You can also download Windows App outside of the Mac App Store as a .pkg file from https://go.microsoft.com/fwlink/?linkid=868963.

Microsoft Office

Select the Office Home 2024 for Mac version from the website → Applications → Office 2024 for Mac → Multi-Language → Microsoft_365_and_Office_16.94.25020927_HomeStudent_Installer.pkg.

Spotify

Download the arm64 version from the official Spotify CDN.

Application Requirements

name url Architecture pros & cons
Google Chrome https://www.google.cn/chrome/
https://www.google.com/chrome/
aarch64 MV2 disabled
Helium https://helium.computer/
https://github.com/imputnet/helium
aarch64 light & MV2 enabled
Vivaldi https://vivaldi.com/ aarch64 MV2 enabled && sync
FDM https://www.freedownloadmanager.org/ Intel64  
v2rayN https://github.com/2dust/v2rayN aarch64  
Clash Verge https://github.com/clash-verge-rev/clash-verge-rev aarch64  
IDEA https://www.jetbrains.com/idea/ aarch64  
Visual Studio Code https://code.visualstudio.com/
https://github.com/microsoft/vscode
aarch64  
Homebrew https://brew.sh/
https://github.com/Homebrew/brew
aarch64  
Stats https://mac-stats.com/ aarch64  
XnView MP https://www.xnview.com/ aarch64  
Snipaste https://www.snipaste.com/ aarch64 purchase to unlock Pro features
Shottr https://shottr.cc/ aarch64 free & OCR
Eudic https://www.eudic.net/ aarch64  
JDK 8 https://www.oracle.com/java/technologies/javase/javase8u211-later-archive-downloads.html aarch64  
Pandoc https://pandoc.org/
https://github.com/jgm/pandoc
aarch64  
Docker https://www.docker.com/ aarch64  
Maven https://maven.apache.org/
https://github.com/apache/maven/
aarch64  
Keka https://www.keka.io/
https://github.com/aonez/Keka
aarch64  
Spotify https://www.spotify.com/ Intel64  
IINA https://iina.io/
https://github.com/iina/iina
aarch64  
Maccy https://maccy.app/
https://github.com/p0deje/Maccy
aarch64  
Postman https://www.postman.com/ aarch64  
JetBrains Toolbox https://www.jetbrains.com/toolbox-app/ aarch64  
Floorp Browser https://floorp.app/
https://github.com/Floorp-Projects/Floorp
aarch64  
Windows App https://learn.microsoft.com/en-us/windows-app/ aarch64  
Microsoft Office https://learn.microsoft.com/en-us/microsoft-365-apps
https://files.rg-adguard.net/category
aarch64  
UTM https://getutm.app/
https://github.com/utmapp/UTM
aarch64  
iTerm2 https://iterm2.com/
https://github.com/gnachman/iTerm2
aarch64  
Raycast https://www.raycast.com/ aarch64  
Node.js https://nodejs.org/
https://github.com/nodejs/node
aarch64  
Starship https://starship.rs/
https://github.com/starship/starship
aarch64  
Git Credential Manager(GCM) https://github.com/git-ecosystem/git-credential-manager aarch64  
DBeaver https://dbeaver.io/
https://github.com/dbeaver/dbeaver
aarch64  
LuLu https://objective-see.org/products/lulu.html
https://github.com/objective-see/LuLu
aarch64  
Codex https://openai.com/codex/
https://github.com/openai/codex
aarch64  
ChatGPT https://chatgpt.com/ aarch64  
Claude https://claude.ai/ aarch64  

For Chinese users

WeChat

Old versions:

  • WeChat for Mac 4.1.8
  • WeChat for Mac 4.1.2

Tencent Meeting

Old versions:

  • Tencent Meeting V3.31.2

Sunlogin Remote Control

Old versions:

  • Sunlogin Remote Control V16.3.0.29006
  • Sunlogin Remote Control V16.1.0.25667

Chinese Apps

name url Architecture pros & cons
WeChat https://weixin.qq.com/ aarch64  
TencentMeeting https://meeting.tencent.com/ aarch64 mandatory account
Sunlogin Remote Control https://sunlogin.oray.com/ aarch64 signup required

[!NOTE] you can download older versions from Homebrew Cask.

Browser Plugin

Plugin Links Chrome Firefox
Translate Web Pages https://github.com/FilipePS/Traduzir-paginas-web https://chrome.google.com/webstore/detail/gkkkcomfmldkigajkmljnbpiajbpbgdg https://addons.mozilla.org/firefox/addon/traduzir-paginas-web/
uBlock Origin https://github.com/gorhill/uBlock https://chromewebstore.google.com/detail/ublock-origin/cjpalhdlnbpafiamejdnhcphjbkeiagm https://addons.mozilla.org/addon/ublock-origin/
Vimium https://github.com/philc/vimium https://chromewebstore.google.com/detail/vimium/dbepggeogbaibhgnhhndojpepiihcmeb https://addons.mozilla.org/en-GB/firefox/addon/vimium-ff/
FDM https://www.freedownloadmanager.org/ https://chromewebstore.google.com/detail/free-download-manager/ahmpjcflkgiildlgicmcieglgoilbfdp https://addons.mozilla.org/en-US/firefox/addon/free-download-manager-addon/
Bitwarden https://bitwarden.com/ https://chromewebstore.google.com/detail/bitwarden-free-password-m/nngceckbapebfimnlniiiahkandclblb https://addons.mozilla.org/en-US/firefox/addon/bitwarden-password-manager/
SwitchyOmega https://github.com/FelisCatus/SwitchyOmega https://chrome.google.com/webstore/detail/padekgcemlokbadohgkifijomclgjgif https://addons.mozilla.org/en-US/firefox/addon/switchyomega/
Imagus https://tiny.cc/Imagus https://chromewebstore.google.com/detail/imagus/immpkjjlgappgfkkfieppnmlhakdmaab https://addons.mozilla.org/en-US/firefox/addon/imagus/

[!TIP] SwitchyOmega → auto switch: GFWList

Reference

  • v2rayN
  • Clash Verge
  • free18/v2ray
  • Installation — Homebrew Documentation
  • Java SE 8 (8u211 and later)
  • Difference Between M2_HOME, MAVEN_HOME and using the PATH variable
  • How to Install Maven on Windows, Linux, and Mac
  • Homebrew 镜像使用帮助
  • What’s new in Windows App
  • Sample shell scripts for Intune admins.
  • SSH config file format


macOSHomebrewApp Store Share Tweet +1