This post will show you how to install LaTeX easily on a Mac with the package manager Homebrew.
The MacTeX-2021 Distribution The current distribution is MacTeX-2021 This distribution requires Mac OS 10.14, Mojave, or higher and runs natively on Intel and Arm processors. As of February 2020, the installation with brew has some issues with scipy and cairo packages in Apple Silicon mode. This can be solved by installing brew in the rosetta2 mode.
Homebrew complements macOS (or your Linux system). Install your RubyGems with gem and their dependencies with brew. “To install, drag this icon” no more. Homebrew Cask installs macOS apps, fonts and plugins and other non-open source software. Homebrew’s package index. Name: BasicTeX Compact TeX distribution as alternative to the full TeX Live / MacTeX. Homebrew’s package index. Name: MacTeX Full TeX Live distribution with GUI applications.
You can directly install MacTex or BasicTex from https://tug.org/mactex/ and follow the instructions from 3 to 4. But I prefer brew for its ease.
1. First you should install Homebrew;
/usr/bin/ruby -e '$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)'
You may look at brew.sh for newer or additional installation methods. After you have installed brew you can easily search for packages with
brew search wget
or install found packages by
brew install wget
You may use brew for installing various packages, command line tools, applications etc.
2. There is a small twist while installing MacTex or BasicTex packages. Because they are supplied at the Homebrew Cask repository. Cask is a community contributed repository for large binaries and applications. So you should add cask command before installing MacTex or BasicTex.
brew cask install basictex
to install basictex or
brew cask install mactex
MaxTex is more than a GB and BasicTex is around 90MBs. There are many packages that you will never use in MacTex thus I prefer the BasicTex.
3. Now you will need a simple text editor to write LaTeX. Then simply use the command line to convert your raw latex code to pdf. You may also use a latex editor like TexMaker if you prefer a GUI. MacTex readily comes with some tex editors.
4. As BasicTex is very lightweight it is missing some essential packages. If you get errors like “multirow.sty not found” while compiling tex then you should install the missing modules. The package tlmgr is used to install the missing modules.
sudo tlmgr install multirow
tlmgr comes with BasicTex.
I have used the following resources to summarize the installation process and install latex myself on El Capitan.
Setting up software for data analysis and statistical computing can be a major pain. Although setup on OSX is substantially less troublesome than on Windows (a lesson I’ve had to learn the hard way at the office), the process is nonetheless time-consuming and can be difficult to get right. I have finally arrived at a pretty clean, maintainable setup which perhaps merits sharing so that others can avoid spending as much time as I have configuring a new machine. This is intended to be a living document and so, I will update this post as technologies or my processes change.
Here is a general overview of the tools I use and what will need to be installed:
Unix Shell (get bash profile with aliases, prompt string, etc from Git)
Python (Anaconda or not to Anaconda)
R (with RStudio)
The first thing you need to do is install Apple’s command line tools (or XCode). This can be done by installing XCode from the App Store, going to preferences, downloads and then installing command line tools.
In versions beyond OSX 10.9, you can also install XCode directly from the command line with
Now we can install Homebrew, a free package management system that simplifies the installation of software on the macOS operating system. To do this, open your Terminal app or whatever terminal emulator you use and enter:
Follow the command line prompts and enter your User password when instructed. By default, Homebrew will be installed such that we can use the
brew command without having to type
sudo and providing a password.
brew doctor after to make sure the installation was successful and that Homebrew is working properly.
To make sure we have the latest Homebrew version and the latest formulas (which we should), we can run
brew update && brew upgrade.
Now we are ready to install some software!
We can install Git with:
Now we’re ready with Git and Homebrew!
I do like to have htop to monitor system usage so I will install it with:
It’s also helpful to have
wget which can be installed with:
At this moment, I do not have a very particular set up for my Unix Shell environment or dotfiles I am particularly attached to so I will move on for now. Watch this space as more steps will be added here shortly.
Vim is a highly configurable text editor built to make creating and changing any kind of text very efficient. It is already included with Apple OS X but we will make sure we have the most recent version installed and configure the editor to our tastes.
To install the latest version, use Homebrew with the following command:
Now we should have the most recent version of Vim installed (if you would like to check, type
vim —version). Additionally, we have also install MacVim, a Vim port to Mac OSX that is meant to look better and integrate more seamlessly with your Mac. The homebrew command above includes the installation of the CLI
mvim and the Mac application (which point point to the same thing).
If you don’t already have a Vimrc file that you like to use, I recommend the Ultimate Vim configuration. On the other hand, if you are just learning vim and starting to incorporate it into your workflow, it might be a good idea to start with a blank rc file and get comfortable with the basic functionality of the editor without any plugins. In my first few weeks of using Vim, I found it useful to slowly incorporate packages and new features into my workflow over time.
If you would like to use the Ultimate vimrc, you can do so by cloning the repo and running the install script:
I debated a lot on the best way to install Python on a system and ultimately landed on the Anaconda distribution. Anaconda is probably the most popular distribution for Data Science since it abstracts away many of the complexities associated with package management, helps keep dependencies updated and comes with many useful Python tools such as Jupyter Notebooks.
The easiest way to install the distribution is through the graphical installer.
Go to the Anaconda Website and choose a Python 3.x graphical installer (at the time of writing this, I am installing Python 3.7). Select only one version of Python and do not install both! If you need to run a program in Python 2, virtual environments allow you to create different versions of Python depending on the project you are working on.
Locate the download and double click it
Click through by hitting “Continue” to install with default settings. Give your admin password when prompted.
I choose to not install Microsoft VS Code, a Python IDE that comes with the distribution, however, you should feel free to if you like to use it.
Note that when you install Anaconda, the program will automatically update your bash profile with
You can also install anaconda from the command line with the following code:
Test your Installation
Note that you need to open a new Terminal window for the changes in your environment variables to take effect.
python —versionin a Terminal window to make sure you have installed the correct version of Python and that your PATH variable has updated correctly. You should get output like:
conda update condato make sure that the conda function is working properly and that you are up-to-date.
Another helpful test is to confirm the installation of Jupyter. Run the command
jupyter notebookto see if a notebook instance launches.
If you have multiple versions of python installed on your computer these tests will not work and you will need to update your
.bash_profile to point to the correct installation of Python.
Python “Hello World”
Most people, myself included, install RStudio alongside R. Almost everyone uses the RStudio IDE and it’s generally considered the easiest and best way to work with R.
Install R and RStudio
There are several ways to do this but I choose to install using the command line and our newly-minted Homebrew.
brew install rin the Terminal
Update your bash profile with the following command:
echo 'Sys.setlocale(category='LC_ALL', locale = 'en_US.UTF-8')' >> ~/.bash_profile
Install R studio by entering
brew cask install rstudio
Install R Packages & Change the RStudio environment
Open RStudio. On the left panel, you should have an R console and terminal. In the console, you can type an R command followed by enter and R will execute the command for you.
To install Tidyverse
install.packages('tidyverse', repos = 'https://cran.us.r-project.org')
You can install a few more useful packages using the syntax
Some useful packages are:
XML: Read and write XML documents with R
jsonlite: Read and create JSON data tables with R
httr: A set of useful tools for working with http connections
rvest: Very useful tool for webscraping
I also like to change the editing colors of RStudio. You can do this by going to Tools > Global Options > Appearance. I personally like the Cobalt theme with Monaco font to reduce eye strain.
R “Hello, World!”
To check that everything works, try creating a simple plot in RStudio.
In the same console panel, load the ggplot library by typing
library(ggplot2). Then type in the command
What this does is instruct R to use
airquality , a pre-loaded dataset, and plot Day versus Ozone. The resulting plot should look something like:
Prepare to set aside a good amount of time (about an hour) to install LaTeX. Since you will have to download a large file, a high-speed internet connection is advisable.
To install LaTeX applications on your Mac:
Brew Mactex Path
Visit http://tug.org/mactex/ and click on the MacTex download link. The file is about 3.2 GB so may take a little while (about 20 minutes) to download.
Once the file has downloaded, double-clink mactex.pkg to begin the installation.
Read and accept the conditions and follow the on-screen instructions to install. The installation may take a few minutes.
After the installation is complete, you can delete the mactex.pkg file.
Since I don’t write that advanced LaTeX anymore, I have found that the editors that come with the MacTeX download are sufficient. TexShop is my go-to editor for editing most LaTex documents.