Installation

1. Install Texpile

Windows

Download the installer and run it. Texpile appears in the Start menu when it finishes.

There is also a portable zip on the downloads page. Extract it anywhere and run Texpile.exe. It keeps its settings in a data folder next to the exe, so the folder can move, and it runs beside an installed Texpile. It registers no file types or texpile:// links, and it does not update itself: when a new version is out, the update window points to the downloads page for a fresh zip.

macOS

Open the .dmg and drag Texpile to your Applications folder.

Linux

On Debian, Ubuntu, and their derivatives, install the .deb with apt rather than dpkg, so the packages it depends on are installed with it. The leading ./ matters. Without it, apt looks for a package by that name in your repositories instead of reading the local file.

wget https://dl.texpile.com/latest/deb -O texpile.deb
sudo apt install ./texpile.deb

Everywhere else, the AppImage runs on most distributions without installing anything. Make it executable and run it:

wget https://dl.texpile.com/latest/linux -O Texpile.AppImage
chmod +x Texpile.AppImage
./Texpile.AppImage

AppImages need FUSE 2, which recent distributions no longer install by default. If it exits with a message about libfuse.so.2 or dlopen, add it:

sudo apt install libfuse2t64   # Ubuntu 24.04 and newer
sudo apt install libfuse2      # Debian 12, Ubuntu 23.10 and older

2. Install a compiler

Pick the one for the format you write in. If you write both, install both.

3. Install git

Only for the Source Control panel. Everything else works without it.

Do I need a compiler?

For editing, no. The visual editor, source editor, spell check, intellisense, and version control all work on their own. For compiling a PDF and for live preview, yes. Texpile runs the compiler on your computer and does not include one.

Check it worked

Texpile checks for you. Preferences › Toolchain lists every external program it runs, for both formats, and whether each one was found.