I recently got a new laptop - a MacBook Air! I customized it so that it's easy for me to use. Major changes include:
- Moving data from my old laptop to my new laptop.
- Installing and configuring software for basic necessities, programming and writing content.
- Setting up a nice environment on my terminal.
As I made all these changes to my new laptop, I noted down the steps that I took for future reference. I think they could be useful to others, so here they are, as a blog post.
This post is written for macOS Mojave. You may have to modify some instructions if you're using a newer macOS. If you're not using macOS, you can still get a similar working environment on Linux, but you'll have to make major modifications to the instructions below.
- Basic setup
- Terminal and Shell
- Install command-line programs
- Transfer backed-up data
- Customize Vim
- Install Nginx and serve website mirrors
- Connect to a WiFi network, since we'll be downloading a lot of stuff.
- Update your OS.
- macOS will offer a tour of the OS. Take that if you're new to macOS.
- Remove useless apps from dock: right-click on the app in the dock, go to Options and uncheck 'Keep in Dock'.
Click the Apple logo in the top-left corner of your screen and choose 'System Preferences'. Here you can customize most aspects of your operating system. If you have the time, go through each of the items and choose the options which make sense to you. These are the changes which I made:
- General: Use dark theme (Appearance: Dark).
- Position on screen: Left.
- Uncheck 'Show recent applications in Dock'.
- Language and Region: Select 'English (US)' as the primary language. I live in India, so the default was 'English (India)', but I changed it because I generally follow US spelling. I don't want my spell-checker to highlight 'color' and 'center' as misspelled words.
- Keyboard: Input Sources: Hide input menu in menu bar.
- Display: Choose Resolution as Scaled and choose the large size.
- Bluetooth: Show Bluetooth in menu bar.
- Change hostname. The hostname shows up in the terminal prompt, so I want it to be short.
- Allow remote login via SSH.
- Siri: Disable Siri. I rarely use it.
- Date and Time: In the 'Clock' tab, check 'Display time with seconds' and 'show date'.
- Accessibility: Siri: 'Enable type to Siri' if you don't want to disable Siri but want to talk to it by typing instead of speaking.
Finder is the file manager in macOS.
- Finder preferences (
Cmd + ,):
- General: Show hard disk and connected servers on desktop.
- Sidebar: Select useful locations.
- Show all filename extensions.
- Keep folders on top in windows.
- Search current folder when performing a search.
- Go to 'View' in Finder's menu bar:
- Show view options (
Cmd + J): 'Sort by Name' and 'Use as Defaults'.
- Show path bar.
- Show view options (
Cmd + Shift + .to enable viewing hidden files.
Install Google Chrome and sync profile¶
I prefer Google Chrome over Safari. I made Chrome the default browser. I also synced my account to get all my bookmarks and extensions.
TextEdit is the default plain-text and rich-text editor bundled with macOS.
I usually use Vim for text editing. Vim is far superior to TextEdit in terms of advanced functionality, like customizability, syntax highlighting, find-and-replace, etc. But having a lightweight GUI text editor can be handy.
TextEdit preferences (
Cmd + ,):
- Format: plain text. This is needed to prevent new instances of TextEdit from opening a rich-text editor.
- Font: Menlo, size 16.
- Disable 'Correct spelling automatically'.
- Display HTML files as HTML code.
- Disable 'add .txt extension to plain text files'. This is needed if you have to edit extensionless files.
Terminal and Shell¶
If you're an aspiring programmer or power user, you should get to know the command-line. For this blog post, I'm going to assume that you know how to run commands from the shell and you know the meaning of the following words: terminal emulator, shell, prompt, home directory, current working directory. In case you don't, here's a nice short tutorial by TreeHouse: Introduction to the Mac OS X Command Line.
Terminal.app is the default terminal emulator on macOS. There are better alternatives, like iTerm2, but Terminal.app is good enough for me, so I didn't bother installing iTerm2.
Creating a new profile with the Solarized color scheme¶
Terminal.app has multiple profiles available. Each profile specifies the color scheme, font face, font size and many other settings. Instead of making changes to the default profile, we're going to create a new profile with our changes.
I use the Solarized color scheme for my terminal because:
- It is an eye-pleasing color scheme. It works well with Vim's syntax highlighting.
- Solarized is a popular color scheme, so it's available on many terminal emulators, text editors, IDEs, etc. This helps me get a unified look-and-feel when switching programs or platforms.
Even though Solarized isn't available out-of-the-box for Terminal.app, the advantages above outweigh the effort required to set it up on the terminal.
- Download the Solarized dark theme for Terminal.app. Open it in finder and double-click on it.
- macOS will say that the file cannot be opened because it is not from an identified developer. Go to 'System Preferences > Security > General' and press 'Open Anyway' (don't worry; it's not an executable).
- Open terminal, 'Preferences > Profiles', select 'Solarized Dark' and press the 'Default' button. Now restart Terminal.app and you'll see the dark blue background of the Solarized color scheme.
- In the 'Preferences > Profile > Text' tab, set opacity to 85% and font size to 16.
- In the 'Preferences > Profile > Window' tab, deselect 'restore text when reopening windows'.
Installing Xcode command-line tools¶
The 'Xcode command-line tools' consist of command-line applications that are very common in Unix-like environments, like git, gcc, make, perl.
xcode-select --install from a terminal.
A dialog box will pop up. Select install.
You should probably connect to a power source before doing this
because macOS is going to suggest you do so.
Dotfiles colloquially refers to configuration files placed in the home directory.
These files' names start with a dot (
Common examples are
I have put all my dotfiles in a Github repository at
You can find detailed instructions for setting them up in the repository's readme.
Here is a brief version:
git clone https://github.com/sharmaeklavya2/dotfiles.git cd dotfiles ./scripts/make_links.py shopt -s dotglob nullglob mv _links/.bashrc _links/.bash_profile mv _links/* ~
Now either restart your terminal or run
If you executed the above instructions correctly,
the first thing you'll notice is the improved, colorful prompt.
My dotfiles are written with the Solarized terminal color scheme in mind.
If you're not using Solarized, you may want to modify or omit using
I also recommend using the
git-prompt.sh utility script, which will display useful information
about git repositories (like branch, dirty status, etc) in your prompt.
To do this, download git-prompt.sh
~/.bash_profile will use it to modify the prompt.
I also recommend adding the line
export HISTSIZE=100000 to either
to increase your shell input history size.
Homebrew (a.k.a. brew) is a package manager, which means it's like a terminal version of the App Store. You can install programs (called packages by brew) by simply writing commands on the terminal:
brew install name-of-package
According to brew's website, brew can be installed by typing this into the terminal:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Installation may require superuser permissions.
I usually need multiple shells to be open.
I can use Terminal.app's 'tabs' (
Cmd + T) to achieve this.
But I use tmux instead since it has more features.
Also, if you SSH to a server that has tmux installed,
you can open multiple shells on the server on a single SSH session.
To install, run
brew install tmux.
Brew will check for updates every time you run it.
To prevent that from happening, add
Install command-line programs¶
brew install java
MacTex is a suite of programs for typesetting documents using TeX and LaTeX. LaTeX is a great system for writing professional-looking mathematical documents.
You can install MacTex using a GUI installer, but I did it using
brew cask install mactex.
Python and packages¶
macOS has Python 2 pre-installed, but we should use Python 3, since Python 2 will reach EOL on Jan 1, 2020.
brew install python3. That will install
I use python virtual environments. I use one big virtualenv where I install all commonly used packages, and I create application-specific virtualenvs for large applications that I'm developing.
pip3 install virtualenv to install the
virtualenv /path/to/venv/ -p python3 to create a python3 virtualenv.
Activate the virtualenv using
Now all python commands and applications you run will use this virtualenv.
I usually install python packages only when required, but some are useful enough that I installed them in the beginning:
pip install ipython requests jinja2 pipdeptree flake8 grip
These packages are useful for math and computation:
pip install numpy scipy pandas matplotlib seaborn sympy
Transfer backed-up data¶
Reorganizing data and backup¶
There are many places where I store my files:
- My laptop's SSD (which is small enough for all my files to not fit on it).
- My external hard drive.
- My Dropbox account.
- My Github repositories.
- My Android phone.
Some of my files are stored on more than one of the above locations. Sometimes the files on one storage medium get updated but not others. This made it very difficult for me to manage them without the risk of accidentally losing some files.
To mitigate this problem, I did a massive reorganization of my files before moving them to my new laptop. I organized them into folders based on the kind of content and access patterns and demarcated which folders will be on which storage mediums.
I moved my frequently-changing content to Dropbox. I use the Dropbox desktop app which syncs my files online in real-time. On my external hard drive, I have an up-to-date backup of content that rarely changes.
If you use git for your code, make sure to push all unpushed code on your old computer to an online remote to avoid losing data.
NTFS drivers for macOS¶
My external hard drive is NTFS-formatted, but macOS cannot write to NTFS drives; it can only read from them. This was problematic when I was transferring my files from my old laptop (which was also a MacBook) to my external hard drive. There are 3 options available:
- Somehow reformat the external drive to FAT32 without losing data.
- Install an open-source NTFS driver. It's hard to make them work and you have to mount/unmount via command-line.
- Install a paid NTFS driver, like Paragon. These work seamlessly, but are either expensive or offer a limited-time trial version.
Fortunately, my external hard drive was a Seagate product. Seagate offers a free-of-charge version of Paragon's NTFS driver which only works on Seagate drives.
Install Dropbox and use symlinks¶
I installed Dropbox's desktop app on my new laptop.
This app creates a directory at
~/Dropbox and downloads all your online content into it.
Anything you put in this directory will get synced to your online account.
Dropbox has the limitation that it will only sync files inside
If I ever change my mind about what to sync, I'll have to move things in and out of
If you're a command-line user, you'll know how annoying it can be to change frequently-used paths.
To solve this problem, I placed all my files outside
and created symlinks to them which I placed in
Edit: This no longer works, since
Dropbox removed support for using external symlinks.
Now I place my files inside Dropbox and created symlinks to access them from outside
Wallpapers and profile picture¶
After transferring files from my external hard drive to my new laptop, I configured macOS to use my custom wallpapers instead of the system-default ones and use my profile picture on the lock screen.
Install newer Vim¶
Although macOS comes with
vim pre-installed, that version of Vim was compiled without some important features.
You can see which features are installed by running
brew install vim to install a newer, better Vim.
Alternatively, you can install MacVim (
brew install macvim).
This will not replace the old vim; the old vim can still be accessed at
mkdir -p ~/.vim/autoload ~/.vim/bundle && \ curl -LSso ~/.vim/autoload/pathogen.vim https://tpo.pe/pathogen.vim
execute pathogen#infect() to your
If you're using my dotfiles,
you'll already have it in your
Get Vim plugins¶
Just go to
~/.vim/bundle and clone the git repositories of the plugins you need.
You can see the list of plugins that I use at
vimpackages.txt in my dotfiles.
If you're using my dotfiles, you can run
This will download the vim plugins from
vimpackages.txt and place them in a directory named
YouCompleteMe is a vim plugin for code auto-completion. To install this plugin:
brew install cmake.
cd ~/.vim/bundle ; git clone --recursive https://github.com/ycm-core/YouCompleteMe.git ; cd YouCompleteMe.
- If you use a python virtualenv, switch to it and then run
./install.py. If you don't switch to the virtualenv before running
./install.py, python auto-complete may not work for external libraries installed in that virtualenv.
The documentation says that MacVim is required,
but I'm able to use YouCompleteMe with Vim installed via
brew install vim.
Fix Vim locale error¶
You may get error messages like this when you start Vim:
Warning: Failed to set locale category LC_NUMERIC to en_IN. Warning: Failed to set locale category LC_TIME to en_IN. Warning: Failed to set locale category LC_COLLATE to en_IN. Warning: Failed to set locale category LC_MONETARY to en_IN. Warning: Failed to set locale category LC_MESSAGES to en_IN.
Fix this by adding
export LC_ALL=en_US.UTF-8 to
(brew forum post).
Install Nginx and serve website mirrors¶
I use Nginx to serve static content. It's useful to access local websites that I downloaded or created.
Install and run Nginx¶
brew install nginx nginx
Now go to http://localhost:8080. You should see a welcome page from Nginx.
Enable nginx autoindex¶
autoindex on; to '
You may also wish to change the port from 8080 to something else by changing the
After making these changes, run
nginx -s reload for the changes to take effect.
Visit http://localhost:8080 again. Now instead of seeing the welcome page,
you should see the list of files in
Serve my websites with Nginx¶
I had backed up compressed archives of my websites to my external hard disk.
I copied the websites from there, uncompressed them, and placed them in
You can put symlinks in
/usr/local/var/www itself cannot be a symlink.
Anyone on your network can see your files in
so you should be careful about what you put there to preserve your privacy.
If you want to prevent others on your network from accessing the http server,
you can restrict Nginx to work on
To do this, go to
listen 8080; to
This is somewhat secure, but not secure against a talented attacker