Two Upcoming Changes in TinyTeX and tinytex

Recently I received an email from CRAN, from which I learned about an accident related to TinyTeX. CRAN requested me to make a change to avoid such accidents in the future, and I’d like to mention this change and also announce another upcoming change in this post.

Preventing accidental installation of TinyTeX

For the sake of convenience, the R function tinytex::install_tinytex() would not ask for user’s confirmation before installing TinyTeX. I assume that users know what they are doing when calling this function, just like calling install.packages() would install R packages without confirmation. I knew this could be problematic since the beginning, because users might call this function inadvertently, and there is not a straightforward way to prevent the installation.

I have enjoyed more than four years’ peace… until someone called this function somewhere in his/her package (presumably inadvertently since this is definitely against the CRAN policy), which installed TinyTeX on CRAN’s machines. What a horror story!

In the next version of the R package tinytex, install_tinytex() will prevent the automatic installation in the following two cases:

1. The environment variable TINYTEX_PREVENT_INSTALL is set to true. This gives the sysadmin a way to disable the installation altogether, and install_tinytex() will simply throw an error.
2. Another LaTeX distribution is detected. In this case, if the R session is interactive(), users will be asked if they want to continue the installation anyway; if the R session is not interactive, install_tinytex() will throw an error telling users that if they are sure they want to install TinyTeX anyway, they can use tinytex::install_tinytex(force = TRUE).

I guess this change should not affect too many people, but it will affect existing users who install TinyTeX via install_tinytex() in a non-interactive R session (e.g., via the command Rscript -e 'tinytex::install_tinytex()) when there already exists a LaTeX distribution in the system. You would have to use the argument force = TRUE. That may be a minor inconvenience, but the gain is that there should be much fewer accidents like the one I mentioned above.

If you want to check if this change affects you, you may install the dev version of tinytex now:

remotes::install_github('rstudio/tinytex')

And see what happens to tinytex::install_tinytex().

If you have any feedback on this change, please feel free to let me know. Currently, I plan to submit the new version to CRAN next week.

Migrating to the rstudio org on GitHub

We plan to migrate the two GitHub repositories, https://github.com/yihui/tinytex and https://github.com/yihui/tinytex-releases to the rstudio organization next week (May 16, 2022). That is, they will become https://github.com/rstudio/tinytex and https://github.com/rstudio/tinytex-releases, respectively. We hoped to migrate the two repositories from my personal account to rstudio to make it safer to build and install TinyTeX, and also easier to manage future contributions to this project.

In theory, this should not affect anyone, because GitHub will automatically redirect the old links to the new ones, including links to the precompiled TinyTeX binaries in GitHub Releases. Anyway, I want to announce this in advance so that you can be better prepared. If you run into any problems with installing TinyTeX next week, please do us a favor file a report immediately. Thanks!

Donate

As a freelancer (currently working as a contractor) and a dad of three kids, I truly appreciate your donation to support my writing and open-source software development! Your contribution helps me cope with financial uncertainty better, so I can spend more time on producing high-quality content and software. You can make a donation through methods below.

• Venmo: @yihui_xie, or Zelle: xie@yihui.name

• Paypal

  • If you have a Paypal account, you can follow the link https://paypal.me/YihuiXie or find me on Paypal via my email xie@yihui.name. Please choose the payment type as “Family and Friends” (instead of “Goods and Services”) to avoid extra fees.

  • If you don’t have Paypal, you may donate through this link via your debit or credit card. Paypal will charge a fee on my side.

• Other ways:

  WeChat Pay (微信支付：谢益辉)	Alipay (支付宝：谢益辉)

When sending money, please be sure to add a note “gift” or “donation” if possible, so it won’t be treated as my taxable income but a genuine gift. Needless to say, donation is completely voluntary and I appreciate any amount you can give.

Please feel free to email me if you prefer a different way to give. Thank you very much!

I’ll give back a significant portion of the donations to the open-source community and charities. For the record, I received about $30,000 in total (before tax) in 2024-25, and gave back about $15,000 (after tax).