Windows auto setup for developing environment

Desktop environment preference for Windows (10 to 11)
Windows 10 〜 11 向けの作業環境セットアップスクリプト

Overview

To reinstall OS more easily when Windows is unstable, we fully automated the installation of some apps. Two tools: Chocolatey and BoxStarter, were very helpful in developing this project.
Windows が不安定な時、OS をより手軽に再インストールするために、 アプリのインストールを全自動化します。このプロジェクトの開発には、 Chocolatey と BoxStarter との、2 つのツールが役立ちました。

System requirements

• x86, x64, or ARM64 computer
• Windows 10 21H2 or later, or 11
• At least 2 GB of physical RAM.
• At least 150 GB of free space is required as system storage.
• Internet connection

Usage

A. Quick install (Recommended)

1. Open the following link in Microsoft Edge:
   下記のリンクを Microsoft Edge で開きます:
   https://boxstarter.org/package/url?https://raw.githubusercontent.com/kurone-kito/setup.windows/master/boxstarter.ps1
   • Or if, for some reason, you only want to install a minimal number of apps, use the URL below instead:
     または諸事情で最小限のアプリのみをインストールしたい場合は、 代わりに下記の URL を使用します:
     https://boxstarter.org/package/url?https://raw.githubusercontent.com/kurone-kito/setup.windows/master/boxstarter.min.ps1
2. A confirmation dialog will appear asking permission to download, run ClickOnce, and allow UAC. Please allow all of them.
   ダウンロード、ClickOnce の実行、そして UAC の許可を求める確認ダイアログが表示されます。 それらにおいて、全て許可してください。
3. The terminal will start, and the setup will prompt you to enter the password for the current user account. It is required for an automatic reboot during setup; You should enter it correctly and press Enter at the end.
   端末が起動し、セットアップで現在のユーザーアカウントのパスワードを入力するよう 促されます。これは、セットアップ中に自動で再起動するために必要なものなので、 正しく入力し、最後に Enter キーを押してください。
4. Some time rebooted, the installation is complete; it will wait for you to enter the Enter key to exit.
   複数回再起動し、インストールが完了すると、Enter キーの入力待ちとなるため、 Enter キーを入力して終了します。
5. Finally, restart Windows manually to complete the setup.
   手動で Windows を再起動して、セットアップ完了です。

B. Classic install

Clone or download and unzip this repository in advance, and run the following command:
予めこのリポジトリをクローン、もしくはダウンロードと解凍した上で、 下記のコマンドを実行します:

PS> .\setup

Do not run from a network folder. The cmd.exe does not support UNC paths, which may cause unexpected behavior.
ネットワークフォルダからの実行は避けてください。cmd.exe が UNC パスに対応していないため、予期しない動作となる可能性があります。

Prompt

1. Setup will ask for two UAC confirmations at the start of execution.
   セットアップは実行開始時に 2 回の UAC 確認を求めます。
2. Setup then asks for login information for a fully automated restart.
   その後、セットアップは再起動の全自動化のためのログイン情報の入力を求めます。

Details

Apps install

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

CLI Apps

note	description
!	DEPENDENCIES: Removing this app may cause this setup to stop working correctly.
-A	without ARM64 Architecture

Benchmark

• Fastfetch

Configuration tools

• chezmoi

Convert tools for Media binary

• FFmpeg
• ImageMagick

Convert tools for Texts

• ! jq
• ! yq

Database

• SQLite

Development

• ANTLR (via Chocolatey)
• fnm: Fast Node Manager
  • Node.js (via fnm)
    • v18 LTS Hydrogen
    • v20 LTS Iron
    • v22
• Mono
• Microsoft Visual Studio Build Tools
  • version 2015
  • version 2019
  • version 2022
• Rust
  • Microsoft Visual Studio ABI

Documentation

• Tealdeer
• wkhtmltopdf

Files management

• 7-Zip

Packages manager

• ! BoxStarter (via Chocolatey)
• ! Chocolatey (via Chocolatey)
  • Chocolatey choco:// Protocol support (via Chocolatey)
• ! Windows Package Manager (via Chocolatey)
• Scoop (directly install)
• SteamCMD

Runtime

• Visual C++ Redistributable Packages (via Chocolatey)
• ! Microsoft .NET Framework Runtime
• Microsoft .NET SDK
  • v6
  • v8

Testing

• mkcert
• ngrok

Version control system

• Apache Subversion (via Chocolatey)
• ! Git
  • ! Git Large File Storage
  • ! git-delta: A viewer for git and diff output
• GitHub CLI

Remote

• awscli
• SwitchHosts

Shell

• ! Microsoft PowerShell
• Microsoft PowerShell Core
• Oh My Posh
• posh-git (via Chocolatey)

Signature

• ! GnuPG: The GNU Privacy Guard

Text Browsing

• cheat (via Chocolatey)
• Links

Text editors

• Neovim
• Vim

Virtualizations

• act
• (-A) Vagrant
  • plugins (via Vagrant)
    • Vagrant Reload Provisioner

Desktop Apps

note	description
-A	without ARM64 Architecture

3D Modeling

• Blender
• FreeCAD

Audios, Videos, and Broadcasting

• Apple iTunes
• iZotope Product Portal
• OBS Studio
• Reflector 4
• VB-CABLE Virtual Audio Device
• VoiceMeeter

Authentication

• Authy Desktop
• Keybase

Benchmark

• MAXON Cinebench

Configuration tools

• Microsoft PowerToys

Development

• Android SDK
• Unity Hub
• VRChat Creator Companion

Devices

• AutoHotkey
• logicool G Hub

Documents and Office apps

• Amazon Kindle

Games

• Epic Games Launcher
• EA Desktop
• Minecraft Java Edition
• Steam
• Stepmania

Memos and Tasks

• Grammarly
• Microsoft To Do
• Notion

Messaging

• Discord
• Facebook Messenger
• Skype
• Slack
• Zoom

Packages manager

• Chocolatey GUI
• WingetUI

Remote

• Real VNC Viewer
• TeamViewer
• Windows Terminal

Runtime

• Microsoft DirectX

Social

• Facebook
• Instagram
• Threads by Instagram
• VRCX
• X/Twitter

Storage

• Adobe Creative Cloud
• iCloud

Text editors

• Sublime Text
• Visual Studio Code

Virtualizations

• (-A) Docker Desktop
• DOSBox-X
• (-A) Oracle VM Virtualbox + Extension Pack
• Windows Subsystem for Linux
• Ubuntu 24.04 LTS for WSL2

Web browsers

• Google Chrome
• Mozilla Firefox ESR
• Tor Browser

Fonts

• 白源: HackGen Nerd (via Chocolatey)
• Lato (via Chocolatey)

Additional setup

Boxstarter, used in our main setup, is not good at setups requiring keystrokes or other operations. For example, it automatically skips after 30 seconds if it accepts keyboard input on any display. To work around this, we have provided an additional setup batch script that does not use Boxstarter.
メインのセットアップで使用している Boxstarter はキー入力などのインタラクションを 要求するセットアップを不得意としており、例えば何らかの表示をした上で キーボード入力を受け付けると、30 秒で自動的にスキップしてしまう特性があります。 これを回避するために、Boxstarter を用いない、追加のセットアップ バッチ スクリプトを用意しました。

Setup will provide voice notification whenever possible if your action is required, so please follow the guidance.
ユーザーの行動が必要な場合、セットアップはできる限り音声で通知していますので、 ガイダンスに従ってください。

Usage

PS> .\additional-setup

Apps install

• Unity Editor (via Unity Hub)
  • version 2019.4.31f1
    • Module: Android Build Support
    • Module: Documentation
    • Module: Language Pack (Japanese)
  • version 2022.3.6f1
    • Module: Android Build Support
    • Module: Documentation
    • Module: Language Pack (Japanese)
  • version 2022.3.22f1
    • Module: Android Build Support
    • Module: Documentation
    • Module: Language Pack (Japanese)

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 を起動することにより、 ルートストアが存在しない場合、初期化します。

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, 22, 22-alpine, 22-slim
ghcr.io/catthehacker/ubuntu	act-22.04, act-latest, ubuntu:full-20.04, ubuntu:full-latest

Test on Virtualbox

Notice: The test environment provided by this repository has been out of maintenance for some time and may not work. Therefore, it may be more reliable to build your virtual environment and run it instead of using this one.
注意: このリポジトリはテスト用の仮想環境を提供していますが、 長らくメンテナンスをサボっていたため、動作しない可能性が高いです。 各々で独自の仮想環境を構築し、その上で動作検証をした方がより確実でしょう。

The test requires a desktop OS that Bash can use. e.g. macOS, Ubuntu desktop.
テストには Bash が使えるデスクトップ OS、例えば、、macOS や Ubuntu などが必要です。

If you are testing on macOS on the ARM64 architecture, please run the setup directly on Parallels, not on this test script.
ARM64 アーキテクチャの macOS 上でテストする場合は、このテストスクリプトではなく、 Parallels 上で直接セットアップを実行してください。

1. Dependencies

• Virtualbox
• Vagrant
  • vagrant-reload plugin

Dependencies auto installation is available on only Mac. In other platforms, you should install manually theirs before testing.

2. Start testing environment

./test win{8.1|10}

Specify the version of Windows.

3. Start to test

Admin> cd \vagrant
Admin> .\setup

4. Destroy

Use vagrant.

vagrant destory -f

See also

• kurone-kito/dotfiles
• kurone-kito/setup.macos

Contributing

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

License

MIT