Table Of Contents

About TeXworks

Getting Started

Contribution

Installation

Building TeXworks

License

About TeXworks

TeXworks is an environment for authoring TeX (LaTeX, ConTeXt, etc) documents, with a Unicode-based, TeX-aware editor, integrated PDF viewer, and a clean, simple interface accessible to casual and non-technical users.

TeXworks is inspired by Dick Koch's award-winning TeXShop program for macOS, which has made quality typesetting through TeX accessible to a wider community of users, without a technical or intimidating face. The goal of TeXworks is to deliver a similarly integrated, easy-to-use environment for users on all platforms, especially GNU/Linux and Windows.

Getting Started

TeXworks is a free and open-source software project. New users are encouraged to leverage this guide, outlining the fundamental process of creating, formatting, and generating PDF documents from within TeXworks.

Contribution

TeXworks thrives on an active community, and welcoming contributions is paramount. If you encounter bugs or have suggestions for improvement, please share them on our issues page. Additionally, you can engage in discussions with other users and developers via our mailing list. Visit the development page to fork a copy of the codebase and start contributing. Visit our homepage for more information. If you are new to contributing to open-source projects, we encourage you to visit this guide to help you get started.

Installation

Pre-built binaries for Windows, macOS, and Linux are available for immediate download from our official website.

Building TeXworks

Notes by Jonathan Kew, updated 2011-03-20, 2015-03-29, 2019-03-21, 2020-06-06 by Stefan Löffler

To build TeXworks from source, you will need to install

• CMake https://cmake.org/

as well as developer packages (or equivalent) for:

• Qt https://www.qt.io/download/
• Poppler https://poppler.freedesktop.org/
• Hunspell https://hunspell.github.io/

along with their dependencies (such as Freetype, fontconfig, zlib, etc.) If you also want to build the scripting plugins (optional), you additionally need development packages for Lua and/or Python. Details will depend on your platform. On Linux or similar systems, your package manager can probably provide all these. On the Mac, required libraries can be obtained, e.g., using Homebrew.

Using the latest stable versions of the dependencies is highly recommended, although TeXworks can be built with versions at least as old as CMake 3.1.0, Qt 5.2.3, poppler 0.24.5, and hunspell 1.2.9.

Once everything is set up, create a folder for building (e.g., "build") and run CMake in it to create a Makefile or Xcode project. Finally, run make or use Xcode to build the application.

Further tips on building TeXworks from source are available on some of the wiki pages:

• https://github.com/TeXworks/texworks/wiki/Building
• https://github.com/TeXworks/texworks/wiki/Building-on-Windows-(MinGW)
• https://github.com/TeXworks/texworks/wiki/Building-on-macOS-(Homebrew)

License

TeXworks is copyright (C) 2007-2024 by Stefan Löffler, Jonathan Kew, and Charlie Sharpsteen. Distributed under the terms of the GNU General Public License, version 2 or (at your option) any later version. See the file COPYING for details.

The SyncTeX code is copyright (c) 2008-2017 by Jérôme Laurens; see modules/synctex/synctex_parser.c for license details.