kurone-kito / setup.windows

🖥 Desktop environment preference for Windows (10, or later)

Windows auto setup for developing environment

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

Overview

In order 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 Chocolatey.
特筆なき場合、原則として Chocolatey 経由でインストールします。

CLI Apps

note	description
!	DEPENDENCIES: Removing this app may cause this setup to stop working correctly.
-A	without ARM64 Architecture
-M	Exclude when using minimal setups

Configuration tools

• chezmoi
• winfetch

Convert tools for Media binary

• (-M) FFmpeg
• (-M) ImageMagick

Convert tools for Texts

• jq

Database

• SQLite

Development

• ANTLR
• CMake
• fnm: Fast Node Manager
  • Node.js (via fnm)
    • v18 LTS Hydrogen
    • v20
    • v21
    • v22
• Mono
• (-M) Microsoft Visual Studio Build Tools
  • version 2017
  • version 2019
  • version 2022
• Rust
  • GNU ABI
  • Microsoft Visual Studio ABI

Documentation

• Graphviz
• (-A) pandoc
• PlantUML
• tldr pages
• wkhtmltopdf

Files management

• (-M) 7-Zip

Packages manager

• ! BoxStarter
• ! Chocolatey
• Chocolatey choco:// Protocol support
• Scoop (directly install)
• SteamCMD

Runtime

• Visual C++ Redistributable Packages
• AdoptOpenJDK
• ! Microsoft .NET Framework Runtime
• Microsoft .NET Core Runtime

Testing

• mkcert
• (-M) ngrok

Version control system

• Apache Subversion
• ! Git
  • ! Git Large File Storage
  • git-delta: A viewer for git and diff output
• GitHub CLI
• GLab: GitLab CLI tool

Remote

• awscli
• (-MX) OpenSSH (install via the Windows feature when on Windows 10 or 11)

Shell

• ! Microsoft PowerShell
• Microsoft PowerShell Core
• Oh My Posh
• posh-git
• sudo

Signature

• ! GnuPG: The GNU Privacy Guard
• (-M) Unbound

Text Browsing

• cheat
• ELinks

Text editors

• Vim

Virtualizations

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

Desktop Apps

note	description
-A	without ARM64 Architecture
-M	Exclude when using minimal setups

3D Modeling

• (-M) Blender
• (-M) FreeCAD

Audios, Videos, and Broadcasting

• (-M) OBS Studio
• (-M) Reflector 4
• (-M) VB-CABLE Virtual Audio Device
• (-AM) VoiceMeeter
• (-M) VSTHost

Authentication

• (-M) Authy Desktop
• (-M) Keybase

Cloud storages

• (-AM) Dropbox

Development

• (-M) Android SDK
• (-M) Unity Hub

Devices

• (-M) AutoHotkey
• (-M) scrcpy
• (-M) logicool G Hub
• (-M) Raspberry Pi Imager

Documents and Office apps

• (-M) Amazon Kindle

Games

• (-M) EPIC Games Launcher
• (-M) Origin (EA Desktop)
• (-M) Minecraft Java Edition
• (-M) Steam
• (-M) Stepmania

Memos and Tasks

• (-M) Grammarly
• (-M) Notion

Messaging and Socials

• (-M) Discord
• (-M) Gitter
• (-M) Mattermost / with CLI tools
• (-M) Zoom

Packages manager

• (-M) Chocolatey GUI

Remote

• (-M) Amazon Workspaces
• (-A) OpenVPN
• (-M) Real VNC Viewer
• (-M) TeamViewer

Runtime

• Microsoft DirectX
• Microsoft XNA Framework
  • v3.1
  • v4.0
• (-M) RPG Tkool VX / Ace RTP

Text editors

• (-M) Sublime Text
• Visual Studio Code

Virtualizations

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

Web browsers

• Google Chrome
• Chromium
• (-M) Insomnia
• Mozilla Firefox ESR
• (-M) Tor Browser

Fonts

• Cascadia Code
• Fira Code: free monospaced font with programming ligatures
• 白源: HackGen Nerd
• Lato

Windows features

NOTICE: In the Home edition, some features are excluded and installed.

note	description
!	DEPENDENCIES: Removing this app may cause this setup to stop working correctly.
-M	Exclude when using minimal setups

• Virtualization features
  • ! Hyper-V
  • ! Virtual Machine Platform
  • ! Hypervisor Platform
  • ! Windows Subsystem for Linux
• Network client
  • NFS Client
  • NFS Administration tools
  • ! OpenSSH
  • Telnet client
  • TFTP client
• Languages
  • en-US
  • (-M) es-ES
  • (-M) fr-FR
  • ja-JP
  • (-M) zh-CN
• Others
  • ! .NET Framework 3.5
  • Microsoft Defender Application Guard
  • TIFF IFilter
  • Windows Developer Mode
  • Windows Feature Experience Pack
  • XPS Viewer

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)

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, 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

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

setup.windows's Issues

Ubuntu install error

ubuntuで./test win 10した時にvirtualbox-extension-packのインストールにミスって死亡。
以下ログの抜粋
`
check virtualbox-extension-pack
install virtualbox-extension-pack
Reading package lists... Done
Building dependency tree
Reading state information... Done
E: Unable to locate package virtualbox-extension-pack
check vagrant
install vagrant
Reading package lists... Done
Building dependency tree
Reading state information... Done
vagrant is already the newest version (1:2.2.4).
0 upgraded, 0 newly installed, 0 to remove and 1 not upgraded.
check vagrant plugin: vagrant-reload
Bringing machine 'win10' up with 'virtualbox' provider...
==> win10: Checking if box 'senglin/win-10-enterprise-vs2015community' version '1.0.0' is up to date...
==> win10: Setting the name of the VM: setup-windows-10
The name of your virtual machine couldn't be set because VirtualBox
is reporting another VM with that name already exists. Most of the
time, this is because of an error with VirtualBox not cleaning up
properly. To fix this, verify that no VMs with that name do exist
(by opening the VirtualBox GUI). If they don't, then look at the
folder in the error message from VirtualBox below and remove it
if there isn't any information you need in there.

VirtualBox error:

VBoxManage: error: Could not rename the directory '/home/desktop/VirtualBox VMs/temp_clone_1555673216330_58256' to '/home/desktop/VirtualBox VMs/setup-windows-10' to save the settings file (VERR_ALREADY_EXISTS)
VBoxManage: error: Details: code NS_ERROR_FAILURE (0x80004005), component SessionMachine, interface IMachine, callee nsISupports
VBoxManage: error: Context: "SaveSettings()" at line 3123 of file VBoxManageModifyVM.cpp
`

windows8/8.1表記

8と8.1が一纏めになってるのと、それを81で処理しているのはわざと？