When Apple produced El Capitan, they modified the system so users could no longer write directly to the /usr directory and this rule remains in effect today. Therefore we replaced /usr/texbin with /Library/TeX/texbin. MacTeX installs TeX Live, the actual TeX Distribution, in /usr/local/texlive/2021, a location often hidden in the Finder. The MacTeX Working Group from the Tex User Group (TUG) constructed an install package which installs TeX Live and everything else needed to run TeX on Mac OS X in one step. This package is free, and uses Apple's standard installer; installation takes four to eight minutes and is automatic.
Download Tex Live
To download the smaller BasicTeX, click Smaller Download. For suggestions on keeping TeX up to date, go to Update Schedule. To Obtain Older Versions of MacTeX If You Are Running Mac OS 10.3 through 10.9, click here. TeX distributions usually bundle together all the parts needed for a working TeX system and they generally add to this both configuration and maintenance utilities. Nowadays LaTeX, and many of the packages built on it, form an important component of any major TeX distribution.
TWGMacTeXDonateFAQFontsHelpReferencesSupportAcknowledgmentsTUG
To obtain the distribution, click the link below. | |||
While downloading, please skim read the rest of the page. | |||
Users who run into trouble often write us without noticing that the solution is on this very page. | |||
MacTeX-2019 requires macOS 10.12, 10.13, 10.14, or 10.15 | |||
Sierra, High Sierra, Mojave, or Catalina MacTeX.pkg [ approximately 3.9G - 08 May 2019] The md5 sum is 927a9bcd8864789c7f33dbd01f8eb8c9 Download with Safari strongly recommended Special Notes for Catalina | |||
MacTeX-2019 works fine on Catalina once it is installed. When Catalina was first released to developers, Apple said that install packages for Catalina must be notarized and software installed must adopt a hardened runtime. These conditions hold for BasicTeX-2019 and Ghostscript, but not for MacTeX-2019. However, the requirements have been turned off for most betas of Catalina and seem to be still off in the release version, so MacTeX-2019 should install without trouble. In one beta version of Catalina, perhaps beta 5, the restriction was turned on and the MacTeX-2019 install package refused to install.An experimental notarized version of MacTeX-2019 installed fine during that betaperiod and is available at http://tug.org/~koch/MacTeX-2019.pkg. It will replace the old MacTeX-2019 install package as soon as Apple reinstates the notarization restriction. | |||
After downloading, move the file MacTeX.pkg to the desktop or another convenient spot,and double click it to install. Follow the straightforward instructions. Installation on a recent Macintoshtakes about ten minutes. At the end of installation, the installer will report 'Success.' But sometimes, the installer puts up a dialog saying 'Verifying..' and then the install hangs. In all cases known to us, rebooting the Macintosh fixes this problem. After the reboot, install again. If other problems are reported during installation, skip to the section 'Installation Errors' below. MacTeX writes a symbolic link /Library/TeX/texbin which indirectly points to the TeX Live binary directory. Configure your GUI programs to use this link. The GUI programs we supply should automatically configure themselves. On older systems, you may have seen the link /usr/texbinwhich did the same thing. When Apple produced El Capitan, they modified the system so users could no longer write directly to the /usr directory and this rule remains in effect today. Therefore we replaced /usr/texbin with /Library/TeX/texbin. MacTeX does not overwrite the TeX Distribution from the previous year. Users who run into trouble can switch to the previous distribution until the new distribution is fixed. Long ago we installed a Preference Pane which could do this switching, but this functionality is now in TeX Live Utility, which is in /Applications/TeX. To switch, use the Configure menu item 'Select Default TeX Live Version.' MacTeX completely configures TeX, so after installationit is ready to use. Go to '/Applications/TeX/Docs and Spell Utilities/READ ME FIRST.pdf' and read this short document to get started. The document leads a new user through the complete process of writing and typesetting a short LaTeX document. The location '/Applications/TeX/Docs and Spell Utilities/Documents' also contains 'What is installed', which lists all the components of MacTeX and their installation locations. MacTeX installs TeX Live, which contains TeX, LaTeX, AMS-TeX, and virtually every TeX-related style file and font. TeX Live is maintained by TeX User Groups across the world.TeX Live is compiled from the same sources for all platforms: Macintosh, Windows, Linux, Unix. MacTeX also installs Ghostscript, an open source version of Postscript,and it installs the GUI programsTeXShop, LaTeXiT, TeX Live Utility, and BibDesk. In '/Applications/TeX/Docs and Spell Utilities/Spelling' it contains an install package for cocoAspell, a spelling service which does not mark LaTeX commands as misspelled. | |||
If you previously installed MacTeX, you may already have your own favorite front ends and GUI programs. Perhaps, in addition, you have Ghostscript from another source such as MacPorts or HomeBrew. In these cases, it is easy to install just the pieces you need.Download MacTeX using the earlier link. Double click to install. Several pages of informationwill be displayed; one of the last is shown below. Click the 'Customize' button to obtain a page allowing you to select one or more of 'TeX Live', 'Ghostscript', 'GUI Applications.'It is not necessary to remove the earlier TeX Live installation before installing a new one, and indeed we don't recommend that because MacTeX makes it easy to revert to the older version if the new version has a flaw. If you really need the extra space, other sections of these web pages explain how to remove older versions of MacTeX. Installation Errors In almost all cases, this error is caused by a faulty download. There is an easy way to check this. Go to /Applications/Utilities and run Terminal. Type
If you are having trouble downloading MacTeX, note that the download link points to a 'multiplexer' site which parcels out requests to various up-to-date CTAN mirrors. Occasionally users have trouble getting the package from this multiplexer. In that case, choose a specific mirror on this mirror page. Sometimes at the end of installation, the installer will report 'The installation failedThe Installer encountered an error that caused the installation to fail. Contact the software manufacturer for assistance.'and a space. Then drag the install package icon 'MacTeX.pkg' and drop it on the Terminal window.Push RETURN. Terminal will print a message and then a long item with letters and numbers.Compare this number to the md5 sum at the top of this page just under the MacTeX.pkg link.If the two numbers are different, your download was defective and you download again.If you downloaded with a third party browser, we recommend trying Safari for the new download.TeX Live 2019 and the various GUI programs installed by MacTeX are up to date as of April, 2019. But various pieces may have been updated since then. Each of our GUI programs has a menu item called 'Check for Updates.' Select this item to update the program to the current version. The TeX Live command line files are updated daily. To install these updates, use TeX Live Utility in /Applications/TeX. The program xdvi requires at least XQuartz 2.7.9. If you use this program, update XQuartz to the latest version at http://www.xquartz.org.
|
Obtaining TeXShop
If you just want to upgrade to the latest TeXShop, get
- Latest TeXShop, Version 4.67 for Intel and Arm on Sierra and higher (54.1 MB)
- Version 4.44 for Yosemite or higher (46.5 MB)
- Source Code for Version 4.67 (requires XCode 12 or later)
Below is a list of changes made in the latest version of TeXShop.
Older versions of TeXShop for earlier systems are available at the bottom of the page.
TeXShop is just a front end to TeX. You also need a TeX distribution. All new users and everyone elsewho wants to upgrade everything should read the following sections.
Shortcut for New Users Who Want To Test Drive TeX
TeXShop is a front end to TeX and LaTeX, but when TeXShop typesets, it calls command line programs in an underlying TeX distribution. This distribution must be obtained separately. The TeX distribution contains the actual typesetting programs by Knuth and others, various fonts used byTeX, and a vast array of support style files and other auxiliary files.
A small distribution adequate for beginners is available by going to http://www.tug.org/mactex/morepackages.html. Click on the link titled 'BasicTeX.pkg.zip' to download. The result will be an Apple install package which will install BasicTeX whendouble clicked. Obtain TeXShop separately. No further configuration is needed, so run TeXShop and try some simple examples from the internet or the TeXShop Help Menu.
Obtaining TeXShop and TeX Live
The standard TeX distribution on the Macintosh is called TeX Live. BasicTeX is a small subset of TeX Live, but anyone serious about TeX should obtain the full distribution. The MacTeX Working Group from the Tex User Group (TUG) constructed an install package which installs TeX Live and everything else needed to run TeX on Mac OS X in one step. This package is free, and uses Apple's standard installer; installation takes four to eight minutes and is automatic. The package installs TeX Live, the complete reference edition of TeX produced in cooperation by TeX User Groups across the world. It also installs Ghostscript and several GUI utilities for TeX including TeXShop, so it is not necessary to get the front end separately. One of the GUI programs it installs is 'TeX Live Utility,' which can keep TeX Live up to date. Everything is completely configured and ready to use once the installer finishes its job.
MacTeX is a large download, over a gigabyte. To obtain it, click on the following link: MacTeX.pkg.
About MacTeX and TeX Live
For more details about MacTeX, go to the MacTeX web page, www.tug.org/mactex.
TeX Live runs on almost all modern operating systems, including Mac OS X, Windows, GNU/Linux, and various forms of BSD Unix. The distribution is the same on all of these systems; nothing has been added, subtracted, or modified to make it work on OS X. The distribution contains essentially every TeX tool in common use today: Plain TeX, LaTeX, AMS-TeX, ConTeXt, XeTeX, and others, as well as a complete array of packages, style files, and fonts.
Another way to get MacTeX is to join TUG; the package is on the DVD sent immediately to new members and once a year to continuing members.This DVD contains extra front-ends for Mac OS X and many other useful TeX utilities. It alsocontains complete TeX distributions for Windows, GNU/Linux, and other Unix systems.
TUG membership benefits include three issues of TUGBoat, the journal of the organization, and additional CD's containing the CTAN TeX archive of style files, packages, fonts, documentation, etc. For details on joining, seehttp://www.tug.org.
Summary
Let's summarize. To use TeX on Mac OS X, it suffices to install TeXShop and BasicTeX. For a more complete installation, install MacTeX.
Max Horn Git Repository
With great effort, Max Horn created a git repository based on an almost complete set of TeXShop sources.See https://github.com/TeXShop/TeXShop.Other Versions of TeXShop
Here is an older version of TeXShop:- Latest TeXShop Version 2 for systems 10.4, 10.5, 10.6, 10.7, 10.8 (50.7 MB, system 10.5 or higher recommended)
From time to time, users have asked for other particular versions of TeXShop. Below, in no particular order, are some of these requested versions.
Mactex El Capitan
- TeXShop Version 4.15 for Yosemite or higher (50.7 MB)
- TeXShop Version 4.01 for Mavericks through El Capitan (50.7 MB)
- TeXShop 3.68; release just before 3.70
- TeXShop 3.65; last version to run on Lion
- TeXShop 3.62; last version to show help movies on Lion and Mountain Lion
- TeXShop 3.59; last version to write CREATOR and TYPE, temporarily available for Alpha users until that program is upgraded (39.9 MB)
- TeXShop 3.37; for a few who cannot update past Lion (69 MB)
- TeXShop 1.43 for systems 10.2 and 1.3 (8 MB)
- TeXShop 1.35e for systems 10.2 and 1.3 (8 MB), provided for a few users who had trouble running 1.43 on system 10.2
- TeXShop 1.19 for system 10.1.5 and lower (1.1 MB)