Instalación

Las versiones se compilan solo para Linux y Windows. macOS: aún no.

Linux: instalador de una línea (recomendado)

Este es el camino más simple. Descarga el último AppImage, verifica su checksum e integra ComdTeX con tu escritorio: entrada de lanzador (rofi, wofi, GNOME, KDE), icono y un comando comdtex disponible en la terminal. Todo queda bajo ~/.local, sin necesidad de sudo.

curl -fsSL https://raw.githubusercontent.com/Sadriica/ComdTeX/main/scripts/install.sh | bash

¿Prefieres descargar directo? El AppImage, el .deb y el instalador de Windows están en la página de Releases de GitHub.

Puedes volver a ejecutar el mismo comando en cualquier momento para actualizar. Para desinstalar de forma limpia (sin tocar tus vaults ni tu configuración):

curl -fsSL https://raw.githubusercontent.com/Sadriica/ComdTeX/main/scripts/install.sh | bash -s -- --uninstall

En distribuciones basadas en Arch, el instalador aplica además un parche adicional: extrae el AppImage y elimina las bibliotecas libwayland-* que trae empaquetadas, porque suelen ser más antiguas que la pila Mesa/Wayland del sistema y hacen fallar la inicialización EGL de WebKit (ventana en blanco). Después de este parche, ComdTeX corre contra las bibliotecas del sistema.

AppImage universal

Si prefieres no usar el instalador, descarga el .AppImage desde la última release, dale permiso de ejecución y lánzalo:

chmod +x ComdTeX_*.AppImage
./ComdTeX_*.AppImage

El AppImage publicado ya viene parcheado en CI para compatibilidad con Mesa 24+, así que corre sin intervención en Fedora, openSUSE Tumbleweed, Debian/Ubuntu y otras distribuciones. Si ves una ventana en blanco en Arch o Manjaro, usa el instalador de una línea de la sección anterior: soluciona exactamente ese problema.

Debian / Ubuntu (.deb)

Descarga el .deb desde la última release e instálalo:

sudo dpkg -i comdtex_*.deb
sudo apt-get install -f   # resuelve dependencias faltantes

Si la aplicación no arranca después de instalar:

sudo apt install libwebkit2gtk-4.1-0

Nota para Arch

En Arch, Manjaro, Fedora u otras distribuciones rolling, usa el instalador de una línea. El repositorio también incluye un PKGBUILD en packaging/aur/comdtex-bin/ (repaqueta el .deb oficial), pero no está publicado en el AUR y está fijado a una versión antigua (1.16.0), así que todavía no sirve para instalar la versión actual. El AppImage crudo, sin el parche del instalador, necesita el ajuste manual descrito arriba. Lo mismo vale para los manifiestos de Flatpak y winget del repositorio: están congelados en 1.16.0 y nunca se publicaron, así que ni flatpak install ni winget install encontrarán ComdTeX.

Windows

Descarga el .exe (instalador NSIS) desde la última release y ejecútalo. El instalador no tiene firma Authenticode, así que Windows SmartScreen puede avisar de un editor desconocido; elige Más información y luego Ejecutar de todas formas. Las actualizaciones dentro de la app sí se verifican por firma (minisign).

Dependencias opcionales

Desde la versión 1.3.0, la compilación de PDF funciona de fábrica gracias al motor LaTeX WASM incluido: no necesitas instalar nada externo para exportar a PDF. Las siguientes herramientas solo son necesarias para flujos específicos:

Herramienta	Para qué se usa
`pandoc`	Exportar a DOCX y Beamer, exportar a Typst, e importar documentos (el PDF ya no depende de esto)
`typst`	Exportar Typst a PDF
`zip`	Backup de vault y exportación de archivo `.cmdx`
`git`	Panel de Git integrado en la app

Si falta alguna herramienta, ComdTeX muestra un aviso ámbar al iniciar. Puedes descartarlo por herramienta individual; la elección se guarda entre sesiones.

Auto-actualización

ComdTeX revisa al iniciar si hay una versión nueva. Si la hay, aparece un aviso dentro de la app, y Instalar la descarga y vuelve a abrir ComdTeX: el AppImage se reemplaza a sí mismo, el instalador de Windows se ejecuta solo y el .deb te pide tu contraseña para instalarse. Cada actualización está firmada con minisign, y la app comprueba la firma antes de instalar nada.

Si instalaste con el instalador de una línea en Arch, Manjaro u otra distro basada en Arch, ComdTeX corre descomprimido (así aplica el instalador su parche) y no puede reemplazarse solo. Desde la 1.32.0 su aviso de actualización lo dice y te copia el comando del instalador: córrelo en una terminal para actualizar. Antes de la 1.32.0, Instalar en esos sistemas reemplazaba la app parcheada por un AppImage sin parchear; mira Solución de problemas si ComdTeX dejó de abrir después de actualizar.

Las actualizaciones dentro de la app empiezan con la primera versión posterior a la 1.30.0; hasta la 1.30.0, descarga cada versión nueva desde la página de releases.

Install

Releases are built for Linux and Windows only. macOS: not yet.

Linux: one-line installer (recommended)

This is the simplest path. It downloads the latest AppImage, verifies its checksum, and integrates ComdTeX with your desktop: launcher entry (rofi, wofi, GNOME, KDE), icon, and a comdtex command available from the terminal. Everything lives under ~/.local, no sudo required.

curl -fsSL https://raw.githubusercontent.com/Sadriica/ComdTeX/main/scripts/install.sh | bash

Prefer a direct download? The AppImage, the .deb, and the Windows installer are all on the GitHub Releases page.

Re-run the same command anytime to update. To uninstall cleanly (vaults and settings untouched):

curl -fsSL https://raw.githubusercontent.com/Sadriica/ComdTeX/main/scripts/install.sh | bash -s -- --uninstall

On Arch-based distros, the installer applies an extra patch: it extracts the AppImage and removes the bundled libwayland-* libraries, since they tend to be older than the system’s Mesa/Wayland stack and crash WebKit’s EGL init (blank white window). After this patch, ComdTeX runs against the system libraries.

AppImage (universal)

If you’d rather not use the installer, download the .AppImage from the latest release, make it executable, and run it:

chmod +x ComdTeX_*.AppImage
./ComdTeX_*.AppImage

The released AppImage is already patched in CI for Mesa 24+ compatibility, so it runs without intervention on Fedora, openSUSE Tumbleweed, Debian/Ubuntu, and other distros. If you see a blank white window on Arch or Manjaro, use the one-line installer above: it solves exactly that problem.

Debian / Ubuntu (.deb)

Download the .deb from the latest release and install it:

sudo dpkg -i comdtex_*.deb
sudo apt-get install -f   # resolve any missing dependencies

If the app does not launch after installing:

sudo apt install libwebkit2gtk-4.1-0

Note for Arch

On Arch, Manjaro, Fedora, or other rolling distros, use the one-line installer. The repository also carries a PKGBUILD in packaging/aur/comdtex-bin/ (it repackages the official .deb), but it is not published on the AUR and is pinned to an old release (1.16.0), so it is not a way to get the current version yet. The raw AppImage, without the installer’s patch, still needs the manual fix described above. The same applies to the Flatpak and winget manifests in the repository: they are frozen at 1.16.0 and were never published, so neither flatpak install nor winget install will find ComdTeX.

Windows

Download the .exe (NSIS installer) from the latest release and run it. The installer is not Authenticode-signed, so Windows SmartScreen may warn about an unknown publisher; choose More info, then Run anyway. Updates inside the app are still signature-verified (minisign).

Optional dependencies

Since v1.3.0, PDF compilation works out of the box thanks to the bundled WASM LaTeX engine: you don’t need to install anything external to export to PDF. The following tools are only needed for specific flows:

Tool	Purpose
`pandoc`	DOCX and Beamer export, Typst export, and document import (PDF no longer depends on this)
`typst`	Typst to PDF export
`zip`	Vault backup and `.cmdx` archive export
`git`	The in-app Git panel

If any tool is missing, ComdTeX shows an amber warning banner on startup. You can dismiss it per tool; the choice persists across sessions.

Auto-update

ComdTeX checks for a new version on startup. If there is one, a banner appears inside the app, and Install downloads it and relaunches ComdTeX: the AppImage replaces itself, the Windows installer runs on its own, and the .deb asks for your password to install. Every update is signed with minisign, and the app checks the signature before installing anything.

If you installed with the one-line installer on Arch, Manjaro or another Arch-based distro, ComdTeX runs unpacked (that is how the installer applies its patch) and cannot replace itself. Since 1.32.0 its update banner says so and copies the installer command for you: run it in a terminal to update. Before 1.32.0, Install on those systems replaced the patched app with a raw AppImage; see Troubleshooting if ComdTeX stopped opening after an update.

In-app updates start with the first version after 1.30.0; up to 1.30.0, download each new version from the releases page.