One-click computer setup - Supports Windows / macOS / Linux

Other Languages: English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Deutsch | Français | العربية | Português | Italiano

• 🚀 One-click install - Set up your new computer with one command
• 🎯 Pre-built profiles - 5 curated profiles for different needs
• 🌐 Cross-platform - Supports Windows / macOS / Linux
• ☁️ Remote config - Fetch latest config from the cloud
• 📦 Package manager - Auto-detect and install package managers
• 🌍 Multi-language - Manual language selection, supports English/Chinese

bash <(curl -fsSL https://github.com/MomoLawson/Quickstart-PC/releases/latest/download/quickstart.sh)

# Method 1: Download and run
Invoke-WebRequest -Uri "https://github.com/MomoLawson/Quickstart-PC/releases/latest/download/quickstart.ps1" -OutFile "quickstart.ps1"
powershell -ExecutionPolicy Bypass -File quickstart.ps1

# Method 2: One-liner
powershell -ExecutionPolicy Bypass -Command "iwr https://github.com/MomoLawson/Quickstart-PC/releases/latest/download/quickstart.ps1 | iex"

Quickstart-PC/
├── src/
│   ├── quickstart.sh       # Bash source code (develop here)
│   └── quickstart.ps1      # PowerShell source code (develop here)
├── dist/
│   ├── quickstart.sh       # Built Bash artifact (don't edit directly)
│   └── quickstart.ps1      # Built PowerShell artifact (don't edit directly)
├── scripts/
│   └── build.sh            # Build script (injects version)
├── config/
│   └── profiles.json       # Software profiles config (JSON)
├── VERSION                 # Single source of truth for version
├── README.md               # English documentation
└── README.zh-CN.md         # Chinese documentation

# Edit source files
nano src/quickstart.sh
nano src/quickstart.ps1

# Build both dist files
bash scripts/build.sh

# Test locally
bash dist/quickstart.sh --list-profiles

Manual language selection with arrow key navigation:

• 🇺🇸 English (en-US)
• 🇨🇳 简体中文 (zh-CN)
• 🧡 繁體中文 (zh-Hant)
• 🇯🇵 日本語 (ja)
• 🇰🇷 한국어 (ko)
• 🇩🇪 Deutsch (de)
• 🇫🇷 Français (fr)
• 🇸🇦 العربية (ar)
• 🇧🇷 Português (pt)
• 🇮🇹 Italiano (it)

Use --lang zh, --lang zh-Hant, --lang ja, --lang ko, --lang de, --lang fr, --lang ar, --lang pt, --lang it or --lang en to skip the language selection menu.

The script automatically fetches config from:

https://raw.githubusercontent.com/MomoLawson/Quickstart-PC/main/config/profiles.json

quickstart.sh --cfg-url https://your-server.com/profiles.json

quickstart.sh --cfg-path /path/to/profiles.json

{
  "profiles": {
    "my_custom": {
      "name": "My Profile",
      "desc": "Custom software combination",
      "icon": "🎮",
      "includes": ["chrome", "vscode"]
    }
  },
  "software": {
    "chrome": {
      "name": "Chrome",
      "desc": "Browser",
      "win": "winget install Google.Chrome",
      "mac": "brew install --cask google-chrome",
      "linux": "sudo apt install -y google-chrome-stable",
      "linux_dnf": "sudo dnf install -y https://dl.google.com/linux/direct/google-chrome-stable_current_x86_64.rpm",
      "linux_pacman": "yay -S google-chrome",
      "check_win": "winget list Google.Chrome",
      "check_mac": "ls /Applications/Google\\ Chrome.app 2>/dev/null",
      "check_linux": "which google-chrome-stable 2>/dev/null"
    }
  }
}

"Execution Policy" error:

powershell -ExecutionPolicy Bypass -File quickstart.ps1

"winget not found":

• Install App Installer from Microsoft Store
• Or run winget in a new terminal after installation

"PowerShell 5.1 required":

• Windows 10+ includes PowerShell 5.1 by default
• Check version: $PSVersionTable.PSVersion

"brew not found":

• The script will auto-install Homebrew
• Or manually: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

"Permission denied":

• Run with bash prefix: bash quickstart.sh

"apt not found":

• The script auto-detects apt, dnf, or pacman
• For unsupported distros, use --cfg-path with custom commands

Issues and Pull Requests are welcome!

1. Edit config/profiles.json
2. Add software entry in "software" section
3. Add software key to the profile's "includes" array
4. Submit PR

1. Edit config/profiles.json
2. Add new profile in "profiles" section
3. Submit PR

MIT