Macbook Setup

1. Set the keyboard from "System Preferences" - use Tab as "Ctrl" key.
2. Set the keyboard from "System Preferences" - use English ABC Extended (or your preferred language).
3. Clean up the desktop menu - remove stuff you don't need.
4. Log in to the App Store with your new or existing Apple ID.
5. Open Settings and update the computer name for access by outsiders. Something like "my-name.local" is recommended.
6. Enable ssh as well.

7. Install brew:

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

8. Ensure brew is updated:

   brew update
   brew tap homebrew/cask-versions
   brew upgrade
   

1. Open Safari and install Firefox and/or Brave browsers.
2. (Optional but not recommended) Install Chrome Dev with brew install --cask google-chrome-dev.
3. Install Tor Browser with brew install tor.

Set up SSH keys as follows:

ssh-keygen -t ecdsa -b 521 -N '' -f ~/.ssh/id_ecdsa
ssh-add ~/.ssh/id_ecdsa

Optionally, if you need to add the public key to a host, run:

ssh-copy-id -f -i path/to/pubkey username@remote_host

Also, add ssh pub keys to Gitlab and/or Github. Don't forget to backup the private key safely.

1. First, install GNU Stow with brew install stow.
2. mkdir -p ~/Workspace ~/Workspace/work ~/Workspace/play ~/Workspace/vendor
3. cd ~/Workspace/play
4. git clone https://github.com/bitsofparag/dotfiles.git

5. Symlink the git config files from the just-downloaded dotfiles repo:

   dotfiles=/path/to/dotfiles
   stow -d $dotfiles -nvt ~ gitconfig # dry run
   stow -d $dotfiles -vRt ~ gitconfig
   

6. Install git extras with brew install git-extras. See commands here.
7. Install fancy diffing with brew install diff-so-fancy.
8. Install fancy quick-to-read man pages utility with brew install tldr.
9. Install Cookiecutter with brew install cookiecutter.
10. (Optional) Install updated Gem from brew with brew install gem. Make sure the correct ruby version is picked up in $PATH. Normally brew installs gem in /usr/local/opt/ruby.
11. If you installed the ri docs as well, then remove all docs with rm -r "$(gem env gemdir)"/doc/*.
12. (Optional) Install Fastlane with gem install --user-install fastlane -NV.
13. Install make essentials with brew install pkg-config automake.
14. Install jq with brew install jq.
15. Install yq with brew install yq.

There are many good terminal emulators out there, such as ZSH, Fish, xTerm etc. Choose what you're most comfortable with. This guide will set up ZSH on top of iTerm2.

1. Open Terminal and install brew install --cask iterm2.
2. Open iterm2 and set to zsh by: chsh -s /bin/zsh.

3. Check $PATH. It should be something like

   /usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin
   

4. Remove /etc/paths file.
5. Install a good, legible font. IBM Plex Mono and Jetbrains Mono are two of my favorites. Set the iTerm font as well.
6. Install "Oh My Zsh" - sh -c "$(curl -fsSL https://raw.github.com/robbyrussell/oh-my-zsh/master/tools/install.sh)".

7. Install syntax highlighting plugin:

   git clone https://github.com/zsh-users/zsh-syntax-highlighting.git \
       ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
   

8. Similarly, install and activate zsh autosuggestions:

   git clone https://github.com/zsh-users/zsh-autosuggestions \
       $ZSH_CUSTOM/plugins/zsh-autosuggestions
   

9. Install fzf.
10. Install fzf keybindings - /usr/local/opt/fzf/install.

11. Symlink zsh config files with functions

    stow -d $dotfiles -vRt $HOME zsh
    
    cat <<EOF > $HOME/.zshenv
    source $HOME/.zshenv.common
    EOF
    
    cat <<EOF > $HOME/.zshrc
    source $ZSH/oh-my-zsh.sh
    source ~/.zshrc.common
    EOF
    

12. Install bat to replace cat: brew install bat.
13. Install CMatrix for fancy clear command (which should be aliased already in the dotfiles; see step 21.)
14. Install tree with brew install tree.
15. Install fswatch with brew install fswatch.

I am not a big fan of NPM. But sometimes I have to use NPM in order to collaborate with other devs or run node packages. Therefore, to prevent me from hurling the laptop at the wall, I chose to work with pnpm and Volta - keeps things sane and simple. Alternatives to them would be either NVM or n.

1. Install Volta via brew: curl https://get.volta.sh | bash. The installation will automatically add entries to the shell profile, like so:

   export VOLTA_HOME="$HOME/.volta"
   export PATH="$VOLTA_HOME/bin:$PATH"
   

   Install the lts and the latest versions of node:

   volta install node@lts  # installs lts
   volta pin node@lts
   volta list
   

2. Install Deno with brew install deno.
3. Install pnpm with curl -f https://get.pnpm.io/v6.16.js | node - add --global pnpm.

4. (Optional) Install global packages:

   pnpm add -g @storybook/cli \
       eslint \
       js-beautify \
       prettier \
       import-js \
       http-server \
       typescript typescript-language-server \
       dockerfile-language-server-nodejs \
       bash-language-server \
       @cloudflare/wrangler \
       semver
   

5. Check the packages installed globally:

   pnpm ls -depth=0 -g
   

6. (If n is installed) If you have other node versions, copy the same packages over with:

   n install <version> --reinstall-packages-from=<prev version>
   

1. Install with brew install pyenv pyenv-virtualenv

2. Install updated python3 version with pyenv install 3.10.2. It should show the following output:

   Installing Python-3.10.2...
   python-build: use readline from homebrew
   python-build: use zlib from xcode sdk
   Installed Python-3.10.2 to /Users/parag/.pyenv/versions/3.10.2
   

3. Set up python3 globally with pyenv global 3.10.2.

4. Install some commonly used packages with pip:

   pip install ansible 'python-lsp-server[all]' \
               requests 'ptvsd>=4.2' flake8 autoflake \
               importmagic epc
   

Taken from here.

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

To uninstall, run rustup self uninstall

cargo install cargo-edit
cargo install cargo-audit
cargo install cargo-outdated
rustup component add rustfmt
rustup component add clippy

To learn Rust with Rustlings, install as follows:

curl -L https://git.io/install-rustlings | bash -s ~/Workspace/vendor/rustlings

Or you can also learn on Repl.it

1. Install golang with brew install go.

2. Set the go workspace with $GOPATH. This should already be set from the shell setup above. If not, then:

   export GOPATH=$HOME/Workspace/vendor/go
   

1. Install java on Catalina with brew tap AdoptOpenJDK/openjdk && brew install --cask adoptopenjdk8.
2. Verify with java -version.

1. TODO: link to file

1. Install emacs:

   brew tap d12frosted/emacs-plus
   brew install emacs-plus
   brew linkapps emacs-plus
   # or ln -s /usr/local/Cellar/emacs-plus/26.3/Emacs.app/ /Applications
   

2. Install spacemacs:

   git clone https://github.com/syl20bnr/spacemacs ~/.emacs.d
   

3. Install Source Code font.
4. Check out the develop branch: cd ~/.emacs.d && git checkout develop

5. Symlink config files from your dotfiles: If using stow, then:

   dotfiles=path/to/dotfiles
   stow -d $dotfiles -vRt ~ emacs  # links spacemacs and other dot configs
   stow -d $dotfiles -vRt ~/.emacs.d/private emacsd-private-snippets # links snippets
   stow -d $dotfiles -vRt ~/.emacs.d/private/local emacsd-private-local # links everything in local
   

   If not using stow,

   ln -s $HOME/Workspace/play/dotfiles/.spacemacs $HOME/.spacemacs
   rm -rf $HOME/.emacs.d/private/snippets
   ln -s $HOME/Workspace/play/dotfiles/snippets $HOME/.emacs.d/private/snippets
   git checkout $HOME/.emacs.d/private/snippets/README.md
   

6. Install iSpell for emacs with brew install ispell.
7. Install ag with brew install ag (for searching in emacs).
8. Install Pygments as a generic syntax highlighter.

9. Install Poppler, a PDF-rendering library with brew install poppler.

   Or open emacs and run pdf-tools-install

10. Install BasicTeX as the latex package with brew install --cask basictex.
    1. Make sure /Library/Tex/bin is in the $PATH. (With dotfiles, you should already have it so).
    2. Update tlmgr with sudo tlmgr update --self.

    3. Install additional latex packages with:

       tlmgr install wrapfig capt-of catchfile
       tlmgr install dvipng titling hyphenat titlesec enumitem
       tlmgr install chemfig simplekv mhchem
       tlmgr install minted fvextra xstring framed # for minted
       

11. Start emacs from the Applications.
12. Enable markdown in org-export-backends (with Customize).

1. Install postgresql with brew install postgresql.
2. Start postgres (not as a background service) with pg_ctl -D /usr/local/var/postgres start.
3. Install TablePlus app (paid) as the GUI utility for all DBs with brew install --cask tableplus.

1. Install aws-cli with brew tap aws/tap && brew install awscli.
2. Install AWS SAM: brew tap aws/tap && brew install aws-sam-cli.
3. Install aws session-manager-plugin with brew install --cask session-manager-plugin. You might need to manually run it once since the program is not verified.
4. Install Cloudman with brew install dutchcoders/cloudman/cloudman.
5. Set up Hashicorp tap for their products with brew tap hashicorp/tap.
6. Install Terraform with brew install hashicorp/tap/terraform terraform-docs.
7. Install Nomad with brew install hashicorp/tap/nomad.
8. Install Consul with brew install hashicorp/tap/consul.
9. Install Packer with brew install hashicorp/tap/packer.
10. Install Vault with brew install hashicorp/tap/vault.
11. Install Waypoint with brew install hashicorp/tap/waypoint.
12. Install Faas with brew install faas-cli.
13. Install Docker desktop for mac.
14. Install Podman with brew install podman.
15. Install Virtualbox with brew install --cask virtualbox.
16. Install Vagrant with brew install --cask vagrant.
17. Install Gas Mask with brew install --cask gas-mask.
18. Install Postman app with brew install --cask Postman.
19. Install Parquet tools for AWS deser with brew install parquet-tools.
20. Install Skopeo with brew install skopeo.
21. Install Multipass with brew install --cask multipass.
22. Install xxh with brew install xxh.
23. Install dive with brew install dive.

• Install socat with brew install socat. It might be already installed.
• Install xquartz with brew install xquartz.
• Log out and log back in
• Run socat TCP-LISTEN:6000,reuseaddr,fork UNIX-CLIENT:\"$DISPLAY\"

1. Install Platformio with brew install platformio. More details on Platformio mode for emacs can be found here.
2. Install cask drivers brew tap homebrew/cask-drivers
3. Install USB to UART support brew install --cask silicon-labs-vcp-driver
4. Install protobuf for protobuf message compilations: brew install protobuf

1. Install Dropbox: brew install --cask dropbox.

1. Install password managers: brew install --cask keepassxc lastpass.
2. If you installed keepassxc:
   1. open the app
   2. create a new password database (.kbdx) and save in Dropbox
   3. set a new master password
   4. go to the app settings
   5. click on "Enable browser integration" and choose Firefox
   6. install the Firefox addon here
   7. go the addon settings and enable http connection (last option in the settings menu)
   8. this opens an authentication dialog where you enter the same details as in the app to enable autofill in browsers

Follow this link to download the app.

1. Open Mail app and set up your accounts.
2. Install Thunderbird with brew install --cask thunderbird.
3. If you use Protonmail, you'll need to add their Bridge app which sets up localhost as the IMAP and SMTP servers.

1. Install Spotify app - brew install --cask spotify
2. Install Spotify CLI - brew install shpotify.
3. Log in to Spotify developer console and create an application.
4. Note down the Client ID and Client Secret.

5. Create a new file in $HOME/.shpotify.cfg and enter the following:

   CLIENT_ID="<client id from 3 above>"
   CLIENT_SECRET="<client secret from 3 above>"
   

6. Open Spotify app and play a song.
7. Run spotify next from the command line. Or other commands from the cli.
8. Install Deezer with brew install --cask deezer.
9. Install Audius with brew install --cask audius.

• Install blender with brew install --cask blender.

1. Install Cryptomator for file encryption with brew install --cask cryptomator.
2. Install Lulu as the firewall to block unknown outgoing connections, with brew install --cask lulu.
3. Install Netiquette as a network tracker GUI utility: brew install --cask netiquette.
4. Install Oversight as webcam and mic monitoring utility: brew install --cask oversight.
5. Install Malwarebytes for malware detection with brew install --cask malwarebytes.

1. Install Mamp with brew install --cask mamp.

1. Install Unity package manager with npm install -g openupm-cli.

2. Install Inkle Studio editor with brew install --cask inky.

   You can find the repo for developing Inkle games here.

1. Install Glances with brew install glances. Run as glances.
2. Install Dust - better du with brew install dust. Run as dust --reverse <folder>.
3. Install Bottom with brew install bottom. Run with btm --help.
4. Install video player VLC with brew install --cask vlc.

5. Install wireshark-like tool for the terminal (depends on go): [UPDATE 2021-02-13] Uninstalled

   brew install termshark
   

   See details on running it here.

6. Install a CI-Friendly tool for document a database, written in Go:

   brew install k1LoW/tap/tbls
   

   See details on running it here.

7. Install MS Remote Desktop with brew install --cask microsoft-remote-desktop.
8. Install Spectacle app as the window manager with brew install --cask spectacle.
9. Install imageoptim-cli with brew install imageoptim-cli.
10. [REMOVED] Install iina as the movie player with brew install --cask iina.
11. (Optional) Install Zoom.us with brew install --cask zoomus.
12. Install Android File Transfer via the DMG file.
13. Install inkscape with brew install --cask inkscape.
14. Install ADR Tools with brew install adr-tools.
15. Install Disk Usage/Free Utility (duf) with brew tap muesli/tap && brew install duf.
16. Install CSV query utility called q with brew install q.
17. Install Graphviz with brew install graphviz.
18. [REMOVED] Install All-in-one-messenger with brew install --cask all-in-one-messenger.
19. Install Video editing software, Openshot with brew install --cask openshot-video-editor.
20. Install Mailstudio app from their downloads page - https://mailstudio.app/
21. Install ngrok with brew install --cask ngrok.
22. Install Bore with cargo install bore-cli.
23. Install livestreaming and screen recording tool OBS with brew install --cask obs.
24. Install imazing with brew install --cask imazing.
25. Install Dictionaries app with brew install --cask dictionaries.
26. Install Slack Desktop app with brew install --cask slack.
27. Install Alt Tab app with brew install alt-tab.
28. Install Signal desktop app with brew install --cask signal.
29. Install Telegram Desktop app with brew install --cask telegram-desktop-beta.