How to Install TeXworks on Linux Mint 21/20

TeXworks is a versatile and user-friendly LaTeX editor designed specifically for creating high-quality, professional documents using the TeX typesetting system. It offers a clean, intuitive interface that allows beginners to get started quickly while providing advanced features for experienced users. In this introduction, we will explore the various aspects of TeXworks that set it apart from other LaTeX editors.

Key Features of TeXworks

  • Cross-platform compatibility: TeXworks is available on multiple platforms, including Windows, macOS, and Linux, ensuring a consistent user experience regardless of your operating system.
  • Integrated PDF viewer: TeXworks comes with an integrated PDF viewer that allows for real-time previewing of your document as you work, making it easy to spot and correct errors before finalizing your document.
  • Syntax highlighting: The editor supports syntax highlighting for LaTeX, making it easier to identify different components of your document and improving overall readability.
  • Auto-completion: TeXworks features a powerful auto-completion system, which helps to reduce typing errors and increase productivity by suggesting commonly used LaTeX commands as you type.
  • Customizable interface: The interface of TeXworks can be tailored to your preferences, allowing you to adjust font sizes, colors, and other visual elements for a personalized experience.
  • Regular expressions search and replace: TeXworks includes advanced search and replace functionality using regular expressions, which simplifies the process of finding and replacing specific text patterns within your document.
  • Scripting support: TeXworks supports scripting using languages like Lua and JavaScript, enabling users to create custom macros and automate repetitive tasks.
  • Extensive documentation: TeXworks provides comprehensive documentation and help resources, making it easy to learn the ins and outs of the software and LaTeX itself.

TeXworks strikes an excellent balance between ease of use for beginners and powerful features for advanced users, making it a popular choice among LaTeX enthusiasts. To help you get started with TeXworks, this guide will demonstrate how to install TeXworks using the official TeXworks Launchpad PPA or Flatpak package manager with the Flathub repository.

Section 1: Install TeXworks with APT

Step 1: Update Linux Mint

Before installing TeXworks, it’s essential to update your system to ensure all existing packages are up to date. This will help avoid any conflicts during the installation process. Run the following command in your terminal to update your system:

sudo apt update && sudo apt upgrade

This command will first update the package list (using sudo apt update) and then upgrade the installed packages to their latest versions (using sudo apt upgrade).

Step 2: Install TeXworks with PPA

In this step, you will import the TeXworks team PPA repository containing the latest version of the software. You have two choices – the stable or the latest repository. The latest repository version is recommended for most users. However, if you import both repositories, the one containing the latest version will be chosen automatically.

Option 1: Import TeXworks Stable Repository

To import the stable repository, run the following command in your terminal:

sudo add-apt-repository ppa:texworks/stable -y

This command adds the stable TeXworks repository to your system’s software sources list.

Option 2: Import TeXworks Latest Repository

To import the latest repository, run the following command in your terminal:

sudo add-apt-repository ppa:texworks/ppa -y

This command adds the latest TeXworks repository to your system’s software sources list.

Step 3: Update the Package List

Before running the installation command, run an apt update to reflect the new imported PPA. This ensures that your system recognizes the TeXworks package from the newly added repository. Run the following command in your terminal:

sudo apt update

Step 4: Install TeXworks

Now that your system is updated and the TeXworks repository has been added, you can install the software using the following command:

sudo apt install texworks -y

This command installs the TeXworks package from the chosen repository (stable or latest) onto your system.

Section 2: Install TeXworks with Flatpak and Flathub

The second installation option is to use the Flatpak package manager. This third-party package manager is designed to work with a wide range of Linux distributions while focusing on security and isolation. Linux Mint prefers using Flatpak over Snapcraft.

Step 1: Enable Flathub

Enable the Flathub repository with Flatpak using the following command in your terminal. This command adds the Flathub repository to your system, making it accessible for installing applications:

sudo flatpak remote-add --if-not-exists flathub

By running this command, you’re ensuring that the Flathub repository is added to your system if it’s not already present. Flathub is a popular source for Flatpak applications, and adding it allows you to access a wide range of software, including TeXworks.

Step 2: Install TeXworks with Flatpak

Now install TeXworks using the following Flatpak command. This command retrieves the TeXworks software from the Flathub repository and installs it on your system:

flatpak install flathub org.tug.texworks -y

This command searches for the TeXworks package in the Flathub repository and installs it on your Linux Mint system.

Section 3: Launch TeXworks

Now that you have installed TeXworks on your system, there are a few ways to launch the application.

Step 1: Launch TeXworks from the Terminal

You can launch TeXworks directly from the terminal by running the following command:


If you have installed TeXworks using Flatpak, you can launch it from the terminal using the following command:

flatpak run org.tug.texworks

Step 2: Launch TeXworks from the Desktop

For desktop users, you can launch TeXworks using the following path on your Linux Mint system:

Taskbar > Office > TeXworks

Example of launching TeXworks application icon on Linux Mint:

Section 4: Getting Started with TeXworks on Linux Mint

This section will cover some essential tips for getting started with TeXworks on Linux Mint. We’ll focus on general tips, customizations, and other helpful suggestions to enhance your experience with TeXworks.

General Tips

  • Create a new TeX document: To start a new TeX document, go to File > New. This will open a new, blank document where you can begin writing your TeX content.
  • Open an existing TeX document: To open a pre-existing TeX document, go to File > Open and navigate to the location of the file you want to open.
  • Save your TeX document: Remember to save your work frequently to avoid losing any progress. Use File > Save or File > Save As to save your document.
  • Compiling your document: To compile your TeX document and generate a PDF output, click the green “Typeset” button in the toolbar or press Ctrl + T. This will run the default typesetting engine, usually pdfLaTeX, and display the PDF output in the integrated viewer.


  • Change the editor theme: To switch to a different editor theme or color scheme, go to Edit > Preferences > Editor and choose a theme from the “Color theme” dropdown menu.
  • Adjust the editor font: To change the font size or style in the editor, navigate to Edit > Preferences > Editor and customize the “Font family” and “Font size” options to suit your preferences.
  • Configure typesetting engines: You can add or modify typesetting engines in TeXworks by going to Edit > Preferences > Typesetting. Click the “+” button to add a new engine or select an existing engine and click the “pencil” icon to edit its settings.

Other Tips

  • Zoom in and out: To zoom in or out within the editor or the integrated PDF viewer, use the Ctrl + + and Ctrl + - keyboard shortcuts, respectively.
  • Toggle the PDF viewer: If you want to hide or show the integrated PDF viewer, go to Window > Show/Hide > PDF Viewer.
  • Split the editor and PDF viewer: To view your TeX document and PDF output side by side, go to Window > Tile Vertically or Window > Tile Horizontally.
  • Jump between source and preview: To quickly navigate between the source code in the editor and the corresponding location in the PDF output, use the Ctrl + Left Mouse Click shortcut in either the editor or the PDF viewer.

These tips will help you get started with TeXworks on Linux Mint and make the most of its powerful features. Remember to explore the built-in help resources and documentation for more in-depth information about using TeXworks and mastering the TeX typesetting system.

Example of TeXworks on a Linux Mint Desktop:

Section 5: Additional Commands & Tips

In this section, we’ll cover some essential commands for updating and removing TeXworks and provide additional tips for managing the software on your Linux Mint system.

How to Update TeXworks

TeXworks should update automatically with your system packages for desktop users using the APT package manager. However, if you want to check for updates manually, use the following command in your terminal:

sudo apt update && sudo apt upgrade

This command updates your package list and upgrades all installed packages, including TeXworks, to their latest versions.

For users who have installed TeXworks using Flatpak, you can update the software with the following command:

flatpak update org.tug.texworks

his command checks the Flathub repository for any updates and upgrades the TeXworks package if a new version is available.

How to Remove TeXworks

When you install TeXworks, it adds quite a few dependencies. To keep your system clean and avoid bloat, it’s best to use the remove command when uninstalling the software.

To remove TeXworks and its dependencies, run the following command:

sudo apt remove texworks

Next, you should remove the imported PPAs. If you want to downgrade from the latest to stable version, reimporting the stable repository would be the quickest option.

To remove the TeXworks PPAs, execute these commands:

sudo add-apt-repository --remove ppa:texworks/stable -y
sudo add-apt-repository --remove ppa:texworks/ppa -y

For users who have installed TeXworks with Flatpak, you can remove the software using this command:

flatpak uninstall org.tug.texworks

This command removes the TeXworks package and its related files from your system.

Conclusion: Installing TeXworks on Linux Mint

Installing TeXworks on Linux Mint is a straightforward process that offers multiple options, including the APT package manager and Flatpak. Following this guide, you can easily set up TeXworks on your Linux Mint system and seamlessly start working with TeX documents.

Additional Resources and Links

To further enhance your TeXworks experience and deepen your understanding of the software, here are some official resources and links:

  • TeXworks Official Website: The official website for TeXworks, where you can find news, updates, and documentation.
  • TeX Live: The TeX Live distribution, includes TeXworks and a collection of TeX-related programs, fonts, and macros.
  • LaTeX Project: The official LaTeX project website, offering valuable resources, documentation, and support for the LaTeX typesetting system.
  • CTAN: The Comprehensive TeX Archive Network, a large repository of packages, styles, and fonts for TeX and LaTeX users.

Share to...