.dotfiles

This is for my personal use. Feel free to use any of these scripts, but run them at your own discretion. I am not responsible for any effects of these scripts on your machine.

Supported Operating Systems

• Windows

  Instructions on how to set that up below

• macOS

  Install XCode command-line tools (to install git)

  xcode-select --install

• Ubuntu (Desktop)/Pop!_OS (Desktop)

  sudo apt update -y
  sudo apt upgrade -y

cd ~ && git clone https://github.com/ksmithut/.dotfiles.git && .dotfiles/setup.sh

Or by using a custom options.sh template not in the .dotfiles directory

cd ~ && git clone https://github.com/ksmithut/.dotfiles.git && .dotfiles/setup.sh ~/.my-options-file.sh

If no custom options file argument is given, it will look for a options.sh in the .dotfiles folder or use the options.template.sh.

Project structure

• bin/ Anything in here gets added to your path. Make sure you chmod a+x anything you add so that it's executable.

• copy/ Anything in here gets copied to your home directory. This would be for things that you would end up changing post-install, such as adding username or machine specific stuff to.

• install/ All of the .sh files in this directory get run on initialization. There is also an programs/ directory in here that we'll explain down further.

• link/ All of the files here get symlinked to your home directory.

• source/ All the files in here get run when you start a new shell, but this is really only sourced because of the link/.zshrc file.

• backup.sh A script to quickly backup your files.

• setup.sh The script to run when setting up your system.

• options.template.sh This is where customization comes in. Using this template, copy the file and rename it to just options.sh. This is how you select how you want your system setup with various environment options.

Environment Options structure

# If the first argument is '_', then the setup script is trying to determine
# the possible environments for this script. You want to
# `echo '{environment}'` for each kind of environment you want to support.
if [ "$1" == '_' ]; then
  echo 'work'
  echo 'play'
  exit
fi

# Every `echo` after this should corespond to a file in `./init/options`
echo 'base'
echo 'chromium'
echo 'zsh'

if [[ " $@ " =~ " work " ]]; then
  echo 'docker'
  echo 'node'
  echo 'vscode'
fi

if [[ " $@ " =~ " play " ]]; then
  echo 'steam'
fi

Create Installation Media

macOS

Download help page Apple Docs

Download the version of macOS you want to install directly from the App Store. When the download completes, it will prompt you to install/upgrade in a dialog. Just cmd + Q out of that. You'll also want to have a USB Drive that has been formated and named Untitled plugged into your computer. Make sure it is formatted as Mac OS Extended (Journaled). Then run the following command:

# Change /Volumes/Untitled to the volume you want it to be
# Or change the "Install\ macOS\ Ventura.app" to the version of mac you want to
# install
sudo /Applications/Install\ macOS\ Ventura.app/Contents/Resources/createinstallmedia --volume /Volumes/Untitled

After that finishes (it will be a while, 20 minutes to an hour maybe?) you'll want to back up all your stuff and shutdown the computer. When you restart, hold down the option key with the USB drive plugged in and select your install media as the boot drive and continue with installation there.

Ubuntu and Pop!_OS

Download the ISOs from their respective sites and write the images to a bootable USB drive using something like balenaEtcher.

Windows

Follow the instructions here

Although the setup script should work for windows, it's still experimental. Well, the whole project is, but this even more so.

Optionally, you may want to run wsl2 to be able to have a functioning linux environment running.

Instructions from here

Open powershell as an administrator and run the following commands:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

Restart.

The following command may fail stating something about linux kernel stuff. You'll need to visit here to download the appropriate driver. After that, you should be able to set the default wsl version to 2.

wsl --set-default-version 2

You'll need to install winget

Next install git:

winget install --exact --id Git.Git

You'll need to quit the shell you're currently in to let git get its PATH all setup.

It is suggested that you move to your home directory or a directory within your home directory.

cd $HOME
git clone https://github.com/ksmithut/.dotfiles.git
cd .dotfiles

Then run:

Set-ExecutionPolicy Bypass -Scope Process -Force; . .\\setup.ps1

Also, in order to fix time, Windows should be made to use UTC rather than local time.

https://askubuntu.com/questions/169376/clock-time-is-off-on-dual-boot#169384

Create a file named WindowsTimeFixUTC.reg with the following contents and then double click on it to merge the contents with the registry:

Windows Registry Editor Version 5.00
[HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\TimeZoneInformation]
     "RealTimeIsUniversal"=dword:00000001

Note: Windows Time service will still write local time to the RTC regardless of the registry setting above on shutdown, so it is handy to disable Windows Time service with this command (if time sync is still required while in Windows use any third-party time sync solution):

sc config w32time start= disabled

Here's a list of apps that don't have a winget command yet as of writing this:

• Battle.net
• Origin