Skip to content
Stefan Löffler edited this page Mar 28, 2015 · 3 revisions

If you have corrections, additions, or updates to the instructions given below - or instructions for another distribution not covered yet -, please contact us (preferably on the mailing list or via email.

Building TeXworks on typical GNU/Linux systems is fairly straightforward. You just need standard build tools (gcc, make, cmake, etc.), and the development files (not just runtime libraries) for Qt4, poppler, hunspell, and dbus. The exact set of packages needed will depend how your distribution arranges things; some examples are given here.

For Windows users wanting to try a build, see the page about installing and [using the MinGW tools](../Building on Windows (MinGW)). Thanks to Alain Delmotte and Tomek for their help in researching, testing, and documenting the Windows build procedure.

For Mac users, see the page about [building on Mac OS X using Homebrew](../Building on Mac OS X (Homebrew)). Thanks to Charlie Sharpsteen for researching and documenting this Mac OS X build procedure.

If you not only want to build TeXworks, but also package it to share with others, have a look at the file PACKAGING in the source tree.

Note: The procedure below uses git clone to download the source code. This is the recommended procedure if you want to work on the source code or if you want to stay up to date with the latest changes of the code. If you only want to build TeXworks once, you can save bandwidth by downloading and unpacking the sources from GitHub.

Fedora

Fedora 9

# yum install poppler-devel qt4-devel hunspell-devel
$ git clone https://github.com/TeXworks/texworks.git
$ cd texworks
$ mkdir build
$ cd build
$ cmake ..
$ make
$ ./texworks

(Thanks to Dave Crossland for this.)

Fedora 10

$ sudo yum groupinstall x-software-development development-tools
$ sudo yum install git poppler-devel poppler-qt4-devel qt-devel hunspell-devel dbus-devel
$ git clone https://github.com/TeXworks/texworks.git
$ cd texworks
$ mkdir build
$ cd build
$ cmake ..
$ make
$ ./texworks

(Thanks to Dave Crossland for this.)

Ubuntu & Debian

$ sudo aptitude install build-essential git libpoppler-qt4-dev libhunspell-dev libdbus-1-dev liblua5.1-0-dev zlib1g-dev
$ git clone https://github.com/TeXworks/texworks.git
$ cd texworks
$ mkdir build
$ cd build
$ cmake ..
$ make
$ ./texworks

Another option is to use the Ubuntu package repository, thus avoiding the need to compile from source.

OpenSUSE

Adapted from a report by msiniscalchi:

Under OpenSUSE 11.1, I had to install the following devel packages:

gcc
make
cmake
hunspell-devel
poppler-devel
libqt4-devel
libpoppler-qt4-devel

Running cmake and then make produces the binary.

Slackware

Adapted from a report by wtx358:

Install the following packages:

qt
hunspell
poppler
poppler-data
dbus

Then run

$ git clone https://github.com/TeXworks/texworks.git
$ cd texworks
mkdir build
cd build
cmake ..
make
./texworks