Simple yet full-featured LaTeX editor for Linux, Windows, and macOS, adhering to the GNOME HIG.
This is a fork of Setzer by cvfosammmm. The original project site is https://www.cvfosammmm.org/setzer/, licensed under GPL-3.0-or-later.
Feedback on design, code architecture, bugs, and feature requests is welcome through this repository's issue tracker.
The application has been redesigned based on the original project to comply with the GNOME HIG—offering a modern and visually polished interface.
The UI/UX design has been thoroughly optimized; I hope you’ll appreciate the meticulous details I’ve crafted :)
NeoSetzer runs on Linux, Windows, and macOS from a single codebase. No platform fork or separate build is required.
| Platform | Status | Runtime stack |
|---|---|---|
| Linux (Ubuntu 26.04+, Debian 14+, Fedora, Arch, ...) | Fully supported | System GTK4 + libadwaita 1.9+ |
| Windows 10/11 (x86_64) | Supported via MSYS2 | Portable MSYS2 UCRT64 GTK4 stack |
| macOS Apple Silicon (ARM64) | Supported | Self-contained .app release package |
| WSL (Windows Subsystem for Linux) | Supported as Linux app | Linux distribution inside WSL |
- Windows portable zip —
setzer_<version>_windows_x64.zipin the GitHub Releases of this fork. Extract anywhere and runucrt64\bin\setzer.bat; no MSYS2 or installer needed. See Using the portable zip. - Debian/Ubuntu package — Prebuilt
.debpackages are published in the GitHub Releases of this fork. Check there for the latest build. - macOS Apple Silicon application — Download
setzer_<version>_macos_arm64.zip, extractSetzer.app, and see macOS packaging notes for the current Gatekeeper and signing status. - Build from source (see below) — works on any Linux distribution or Windows (via MSYS2) with the dependencies available.
NeoSetzer is developed and tested on Ubuntu.
Supported distributions: The prebuilt
.debrequires GTK 4.10+, libadwaita 1.9+ (GNOME 50 or newer; the app also usesAdw.ToggleGroup,Adw.Spinner,Adw.ShortcutsDialogandAdw.Sidebar) and Python 3.10+; these constraints are declared in itsDepends, so it targets Ubuntu 26.04 or newer and Debian 14 (forky) or newer. Older releases do not satisfy the constraints: apt refuses the install (e.g. Ubuntu 24.04 ships libadwaita 1.5, Ubuntu 25.10 ships 1.8), and building from source does not help either (the GI bindings above are resolved at import time). Upgrade the system or use Flatpak instead.
gir1.2-webkit-6.0is an optional dependency (Recommends) used only by the embedded browser in the help panel. Without it the app starts normally and help pages open in the system browser.
-
Run the following command to install prerequisite packages:
# Run in a Linux terminal apt-get install meson ninja-build python3-gi gir1.2-gtk-4.0 gir1.2-gtksource-5 gir1.2-pango-1.0 gir1.2-poppler-0.18 gir1.2-webkit-6.0 gettext python3-cairo python3-gi-cairo gir1.2-adw-1 python3-numpy gir1.2-xdp-1.0Note:
gir1.2-xdp-1.0(the libportal GIR) is only used for Linux/Flatpak detection.gir1.2-webkit-6.0is only used by the embedded browser in the help panel and can be skipped; without it help pages open in the system browser. Neither is needed on Windows (see note below). -
Clone the NeoSetzer repository from GitHub:
# Run in a Linux terminal git clone https://github.com/Sam-Fic/NeoSetzer.git -
Change into the NeoSetzer folder:
# Run in a Linux terminal cd NeoSetzer
-
Run meson:
# Run in a Linux terminal meson setup builddirNote: Some distributions may not include systemwide installations of Python modules which aren't installed from distribution packages. In this case, you want to install NeoSetzer in your home directory with
meson setup builddir --prefix=~/.local. -
Install NeoSetzer with:
# Run in a Linux terminal ninja install -C builddirOr run it locally:
# Run in a Linux terminal ./scripts/dev/setzer.dev
NeoSetzer supports Windows natively. The GTK4 runtime stack is provided by MSYS2 (the only reliable source of up-to-date GTK4 / libadwaita / GtkSourceView 5 / Poppler binaries on Windows).
There are two ways to get it running:
- Portable zip — the easy way, no MSYS2 required. See directly below.
- Build from source — for development or if you want to modify NeoSetzer. See Step 1 onwards.
setzer_<version>_windows_x64.zip is a self-contained build (~128 MB, ~349 MB extracted) that bundles Python, GTK4 and every other runtime dependency. Nothing needs to be installed and nothing is written to the registry.
-
Download
setzer_<version>_windows_x64.zipfrom the GitHub Releases page. -
Extract it anywhere you like — a USB stick,
D:\Apps\NeoSetzer, your desktop. There is no fixed installation path.Right-click → "Extract All…" in File Explorer works. So does PowerShell:
Expand-Archive setzer_74_windows_x64.zip -DestinationPath D:\Apps\NeoSetzer
-
Run
ucrt64\bin\setzer.batinside the extracted folder — double-click it in File Explorer, or call it from cmd / PowerShell.PowerShell note: run it without quotes, or prefix it with the call operator (
& "…\setzer.bat"). A bare quoted path is treated as a string and only echoed, not executed. -
To pin it to the taskbar or Start menu, create a shortcut to
setzer.bat(right-click → "Send to" → "Desktop (create shortcut)").
To uninstall, just delete the folder. Your settings live in %LOCALAPPDATA%\setzer (i.e. C:\Users\<you>\AppData\Local\setzer) and are kept across versions — remove that folder too if you want a completely clean state.
Do I still need MSYS2? No. Everything is bundled. Do not add the extracted
ucrt64\binto your systemPATH— if you also have MSYS2 installed, the two GTK4 stacks can shadow each other and cause hard-to-diagnose DLL errors.LaTeX is still a separate install. The zip contains the editor, not a LaTeX distribution — see "Installing a LaTeX distribution on Windows" below.
To build from source on Windows, install MSYS2, then follow the dependency installation and build steps in docs/packaging/windows.md.
To build your documents from within the app you have to install a LaTeX interpreter. For example if you want to build with XeLaTeX, on Ubuntu this can be installed like so:
apt-get install texlive-xetex
To specify a build command open the "Preferences" dialog and choose the command you want to use under "LaTeX Interpreter".
It is recommended to use the new fast compiler PhiTeX—this application has been adapted for it.
See docs/packaging/debian.md for the Debian package and release workflow.
See docs/packaging/windows.md for the Windows portable-package workflow, and docs/packaging/macos.md for the macOS application-package workflow.
Development and discussion for this fork take place on GitHub at https://github.com/Sam-Fic/NeoSetzer. For the original upstream project, see https://github.com/cvfosammmm/setzer.
NeoSetzer draws some inspiration from other LaTeX editors. For example the symbols in the sidebar are mostly the same as in LaTeXila, the autocomplete suggestions are mostly the same as in Texmaker. Syntax highlighting schemes are based on the Tango scheme in GtkSourceView and the Gnome Builder Scheme.
Icons: Icon Library UI Design Reference: GNOME Text Editor Reference Project for AI Annotations Feature: Papilot Fast LaTeX Compiler: PhiTeX
NeoSetzer is licensed under GPL version 3 or later. See the COPYING file for details.
