This repo contains my setup files for Mac, Linux, Windows.

This README is a symlink to the setup.sh script in the macos directory.

Look in the windows folder, to see my setup for Windows Subsystem for Linux (WSL), Windows Terminal, and AutoHotkey (eventually to be replaced by the KSM PowerToy).

Look in the linux directory, to see my everything related to linux (including WSL).

Why Mac?

MacOS

MacOS is UNIX-based, unlike Windows, though WSL is a really big step forward.

The best option would be to install Linux on a Mac and configure the modifier keys (Cmd/Alt/Ctrl) to work like in MacOS, but who has time for that?

Modifier keys

The Command key is used for MacOS keyboard shortcuts, limiting conflicts with Unix shortcuts that use Alt/Option or Control.

Longevity

Macs are built to last. I am writing this in 2020 on a 2014 MacBook Air. No PC has ever lasted this long in my experience.

Mac System Preferences

In System Preferences > Keyboard > Keyboard:

Key Repeat: Fast

Delay Until Repeat: Short

Caps Lock Key: Escape

Remove most icons from Dock

2-finger click on Dock and Turn Dock Hiding On

Under General > Sound turn off all sounds and "Show volume in menu bar"

Add Home to Finder sidebar

Under General > Appearance select 'Use Dark menu bar and Dock' and 'Automatically hide and show the menu bar'

Brew - commandline package manager

Install Homebrew (this also installs xcode tools needed for git)

Zsh config

powerlevel10k config

git config

Font and Applications

Install Karabiner-Elements with brew cask (below) or from homepage dmg https://pqrs.org/osx/karabiner/

Install Fira Code Nerdfont and .app programs

Install r (so that the rmarkdown render alias and Nvim-R work in base environment)

Use brew cask install r: https://rstats.wtf/set-up-an-r-dev-environment.html#what-about-homebrew

Set up mac terminal

In terminal, under Profiles > Text: Select Fura Code Nerdfont size 18

In terminal, under Profiles > Advanced: Deselect audible bell

Set up iterm2

In iterm2, select General > Preferences: Select load preferences from a local folder or URL

In iterm2, select Appearance > Theme: Minimal

In iterm2, select Profiles > Keys: Both option keys to Esc+

In iterm2, select Profiles > Terminal, Under Notifications, Silence bell

In iterm2, select Fura Code Nerdfont size 18 in Profiles > Text > Change Font and check Use Ligatures

Set up karabiner

Under Complex modifications > Rules you should see

Change caps_lock to control if pressed with other keys, to escape if pressed alone. (from Change caps_lock key (rev 4))

Change right_command+hjkl to arrow keys (from Examples)

Bash style Emacs key bindings (rev 2) (from Emacs key bindings (rev 12))

Emacs key bindings [option+keys] (rev 5) (from Emacs key bindings (rev 12))

Set up Visual Studio Code

Shell programs needed for aliases

Install fzf (fuzzy finder)

Install bat and exa (for fzf file preview)

Install fasd and fd (to provide inputs for fzf)

Install xpdf (e.g. pdftotext - for fzf PDF file preview)

Install vim and neovim

Install fzf key bindings and fuzzy completion

Use Bash as a backup

Download dotfiles (configuration files)

Vim

Neovim

SpaceVim

JetBrains IDEs

Set up oh my tmux

Set up ipython

Python and R

Install miniconda Python

Install nodejs (for coc.vim) and python packages (for nvim-R and ncm-R):

https://github.com/jalvesaq/Nvim-R/blob/master/doc/Nvim-R.txt#L1953

I don't use jupyterlab-git extension, I only demo it in classes

jupyter labextension install @jupyterlab/git

jupyter serverextension enable --py jupyterlab_git

jupyter labextension install jupyterlab_vim

Set up jupyterlab-github extension

jupyter labextension install @jupyterlab/github

pip install jupyterlab_github

Provide access token to GitHub extension

https://github.com/jupyterlab/jupyterlab-github#2-getting-your-credentials-from-github

Setup PyCharm

Sync settings from https://github.com/marskar/PyCharm

Under File > Settings Repository..., select Overwrite Local

Settings

Select MacOS X 10.5+ Keymap and make the following changes:

- Execute Selection in Python Console: Cmd+Enter

- Editor Actions > Split Line :

- Editor Actions > Decrease Font Size : Cmd+-

- Editor Actions > Increase Font Size : Cmd++

- Editor Actions > Reset Font Size : Cmd+0

- Main Menu > File > Save As...: Cmd+Shift+S

- Main Menu > Scientific Notebook > Edit Cells > Split Cell : Ctrl+Shift+-

- Main Menu > Scientific Notebook > Edit Cells > Split Cell : Ctrl+Shift+-

- Other > Images > Zoom Out : Cmd+-

- Other > Images > Zoom In : Cmd++

- Other > Images > Actual Size : Cmd+0

In Appearance & Behavior > Appearance, Select Darcula theme and select Fura Code Nerd Font size 14

Using Cmd+Shift+A or going to View > Appearance at the Top, enable Details in Tree Views, disable Tool Windows Bars and Navigation Bar

In MacOS System Preferences: Keyboard > Services, uncheck Open man Page in Terminal (Cmd+Shift+M) and Search man Page Index in Terminal (Cmd+Shift+A)

In Editor > Font, select Fura Code Nerd Font size 16 as main and Jetbrains Mono as fallback and Enable font ligatures

In Editor > Code Style, set visual guides to 80 characters

Check Change font size (Zoom) with Command+Mouse Wheel in Editor > General

Check Show Whitespace in Editor > General > Appearance

If you use the Deep Ocean Editor theme from the Material UI plugin, change docstring (Doc comment > Text) color to 4cbb17 aka kelly green and line comment color to DF00FF aka psychedelic purple under Editor > Color Scheme > Language Defaults

In Build, Execution, Deployment > Console, select Use existing console for "Run with Python Console"

Disable Material UI to got back to Darcula theme, but keep Code Editor theme as Deep Ocean

Editor > Color Scheme : Material Deep Ocean

Appearance and Behavior > Appearance > Theme : Darcula

In Editor > General > Editor Tabs, Select None for Tab placement (current file is shown at the top)

Install IdeaVim plugin

Install BashSupport plugin

Install Markdown plugin

Install R Language Support plugin

Fix shortcut conflicts under Preferences > Vim emulation: Ctrl+J/G/M/I/T to IDE

When setting run configurations (ctrl+alt+r), set working directory to project root under Environment and deselect Run with Python Console under Execution

Install RStudio (this also installs r-essentials; RStudio was working for me as part of Anaconda 5.2.0)

Installing r into base environment breaks nvim-R

Install and symlink macvim (brew installed macvim conflicts with brew installed vim)

ln -s /usr/local/Cellar/macvim/**/MacVim.app/ /Applications/MacVim.app