Instalación

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

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 o el PKGBUILD en packaging/aur/comdtex-bin/ (repaqueta el .deb oficial con integración de escritorio completa). El AppImage crudo, sin el parche del instalador, necesita el ajuste manual descrito arriba.

Windows

Descarga el .exe (instalador NSIS) desde la última release y ejecútalo.

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 si hay actualizaciones automáticamente al iniciar. Si hay una versión nueva, aparece un aviso dentro de la app: no hace falta visitar GitHub. Al hacer clic en Instalar, descarga la actualización y relanza la aplicación. Todos los artefactos están firmados con minisign; el actualizador verifica la firma antes de aplicar cualquier cambio.

Install

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

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 or the PKGBUILD in packaging/aur/comdtex-bin/ (repackages the official .deb with full desktop integration). The raw AppImage, without the installer’s patch, still needs the manual fix described above.

Windows

Download the .exe (NSIS installer) from the latest release and run it.

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 updates automatically on startup. If a newer version is available, an in-app banner appears: no need to visit GitHub. Clicking Install downloads the update and relaunches the app. All artifacts are signed with minisign; the updater verifies the signature before applying any update.