tinytex logo

TinyTeX: A lightweight and easy-to-maintain LaTeX distribution

Why TinyTeX?

What is the pain with other LaTeX distributions?

2017-12-15


Some developers may doubt if I’m just reinventing wheels. I certainly don’t want to reinvent wheels for no reason. As I said on the homepage, my own pain with existing LaTeX distributions is that they are often too big, and the documentation, while being comprehensive and useful, usually does not highlight the most useful part to me (how to find and install a missing package).

I also dislike the fact that it often requires sudo (on *nix) to manage LaTeX packages. For personal computers, I don’t see any point of requiring sudo, considering the fact that TeX Live can be a self-contained folder that can be placed anywhere on your computer. I waited for a couple of years before tlmgr was finally available on Debian/Ubuntu, and I was extremely excited about it, but soon disappointed, because it seemed to be broken and not usable at all (couldn’t do anything with it). I checked it again this year, and it still seems to be broken. Perhaps I didn’t use it correctly (anything I try will lead to errors), but you are only allowed to use the user mode of tlmgr, which is very restrictive to me.

My daily OS is macOS, and the officially recommended TeX Live distribution is MacTeX, which contains several additional packages that I don’t need, such as the TeX Live Utility (I know how to use the tlmgr command), TeXShop (I use R Markdown primarily and hope not to edit or even read raw LaTeX if possible), LaTeXiT, and so on.

In fact, I appreciate one nice feature of MiKTeX on Windows (which seems to be cross-platform now): automatically installing missing LaTeX packages. I think this is very helpful, so I borrowed this feature to the R package tinytex, and R users can enjoy the same feature when using TeX Live or TinyTeX. That said, even the basic MiKTeX is still too big, and one issue that drives me crazy is bibtex.exe in MiKTeX: it always adds the .bib extension to the bibliography database file in the .aux file, e.g., when we have \bibliography{foo.bib} in bar.tex, bibtex.exe generates \bibdata{foo.bib.bib} in bar.aux. Anyway, I have patched this issue in the R package tinytex for Windows users who use MiKTeX. TeX Live users don’t suffer from this issue.

On this page, I’ll let other users share their stories of installing and managing LaTeX. First I want to show a list of painful cases that I was aware of:

Below are stories and experiences contributed by other users:

Removed TeX Live from my system (openSUSE): 1.5gb. Installed TinyTeX + the dependencies to compile my thesis: 150mb!!!! This is great!

Bruno Rodrigues

Really liking the simplicity of tinytex package. Easy to get up and running to knit PDFs. No need for slow LaTeX install.

Daley Mikalson

A tiny LaTeX distribution easy to install from RStudio or on Travis CI is just what we needed!

Philippe Grosjean

Seriously one of my only holdups teaching LaTeX in Rmarkdown (still taught it anyway) is now solved.

Tyson Barrett

Tried TinyTeX with rmarkdown and both English and Chinese rendering. The most smooth experience ever using LaTeX!

Kun Ren

TinyTeX is awesome, if it had existed before I would have saved hours of my life spent dealing with LaTeX packages and failed R Markdown knits…

Antonio Vazquez Brust

Many people don’t realize that Texlive on some Linux systems (say you need a rstudio server) doesn’t come with the TeX package manager. If the package you need is not in their system, you are basically screwed as you can’t even install it. TinyTeX solves this problem and makes everything sweet and easy. Also, after using it for more than a month, I found the messages of tinytex are very helpful, comparing with basically NULL in texlive.

Hao Zhu

I’m a novice with R and I found the entire process of installing rmarkdown, knitr, MiKTeX, and pandoc and then reconciling all their directories very difficult. […] The 3-4 hour detour into MiKTeX etc and how to produce PDFs was a frustration experience to say the least. (Up and running with TinyTeX five minutes later…)

— Justin Shapiro

If you work in a locked down windows corporate enviroment and spent countless hours with MiKTeX or portable MiKTeX, you’ll want to buy @xieyihui lunch.

Thomas Speidel

Too bad, this computer had a good month of TeX-free.

Romain François

I’d been avoiding installing LaTeX on my macOS and Windows machines b/c it’s always such a hassle. Just learned about about TinyTeX today and easily got setup on both machines.

John Blischak

Like 2 hours later, I’m not sure I want to know, but there must be a faster way of updating all my TeX packages than the ftp in TeX Live Utility…

Mara Averick

Installing a complete version of MiKTeX is a freaking nightmare though. Don’t know if it’s my internet connection or what but I just can’t get it all installed in one go. I finally just did the basic install and am selecting batches of pkgs at a time to add.

[…] I just installed this (TinyTeX) and it was SO EASY and I’m kind of upset that I didn’t know about it before. Gonna be shouting this one from the rooftops.

Kim Cressman