LinuxCommandLibrary

tlmgr

Manage TeX Live packages

TLDR

Install a package and its dependencies

$ tlmgr install [package]
copy

Remove a package and its dependencies
$ tlmgr remove [package]
copy

Display information about a package
$ tlmgr info [package]
copy

Update all packages
$ tlmgr update --all
copy

Show possible updates without updating anything
$ tlmgr update --list
copy

Start a GUI version of tlmgr
$ tlmgr gui
copy

List all TeX Live configurations
$ tlmgr conf
copy

SYNOPSIS

tlmgr [options] command [arguments]

PARAMETERS

--help
    Display help information.

--version
    Show the version of tlmgr.

--gui
    Start the graphical user interface (if available).

--repository
    Specify the repository to use (instead of the default).

--location
    Show the current TeX Live installation location.

update [package(s)]
    Update specified packages or all packages if none are given.

install
    Install specified packages.

remove
    Remove specified packages.

option
    Set or list configuration options. Use `tlmgr option help` for details.

repository add|remove|set
    Manage repositories

--all
    Apply the action to all packages.

--self
    Update tlmgr itself.

DESCRIPTION

tlmgr (TeX Live Package Manager) is the primary tool for managing a TeX Live installation. It allows you to install, update, and remove packages; manage repositories; and configure various settings of the TeX Live system.

It provides a command-line interface for performing these operations. This interface is crucial for automated TeX Live maintenance and administration, especially on systems without graphical interfaces. It is the recommended way to manage TeX Live installations.

It's used to keep the installation up-to-date, adding or removing packages based on specific needs, and even switching between different TeX Live mirrors. The utility ensures that TeX Live remains consistent and usable by managing dependencies and applying updates in a controlled manner.

Understanding tlmgr's features is essential for maintaining a TeX Live system, especially in environments that need consistent and reliable typesetting.

CAVEATS

Many operations require administrator privileges. Running tlmgr without sufficient privileges may lead to errors or incomplete updates. It is essential to ensure correct internet connectivity when using online repositories, as update and installation processes rely on downloading package data.

PACKAGE NAMING

TeX Live packages often have names that correspond to the LaTeX package or class they provide, but this is not always the case. You might need to consult the documentation or online resources to determine the correct package name for a particular LaTeX component.

LOCAL CONFIGURATION

tlmgr stores its configuration data in files within the TeX Live installation directory. Modifying these files directly is not recommended; instead, use the tlmgr command to manage configuration options.

HISTORY

tlmgr was introduced as part of TeX Live, an open-source TeX distribution. It aims to simplify package management compared to older methods. Development focuses on making TeX Live more manageable, especially for users unfamiliar with command-line tools. The command is now a core part of TeX Live and receives continuous improvements.

Earlier versions relied on manual adjustments, which could be difficult. Nowadays tlmgr automates dependency resolution and updating processes, enhancing usability. Over time, the package manager has incorporated features for repository handling, option configuration, and even a graphical interface.

SEE ALSO

tex(1), latex(1)

Copied to clipboard