LuaX binaries

Installation from sources

It is highly recommended to build LuaX and friends from sources instead of relying on possibly outdated binaries. If you still prefer to download archives of prebuild LuaX binaries, you can jump to LuaX light or LuaX full.

For the bravest, here are instructions to compile and install LuaX.

Prerequisites

To compile LuaX from scratch, you first need:

• Ninja

Installation path

These softwares are installed by default in ~/.local/bin and ~/.local/lib. If the environment variable PREFIX is defined, they are installed in $PREFIX/bin and $PREFIX/lib.

$ export PREFIX=install/path

LuaX

$ git clone https://github.com/CDSoft/luax
$ cd luax
$ ./bootstrap.sh && ninja install
$ cd ..

The next command sets some LuaX variables (PATH, LUA_PATH, LUA_CPATH). It can also be added to your shell configuration (.bashrc, .zshrc…).

$ eval "$(~/.local/bin/luax env)"

or

$ eval "$($PREFIX/bin/luax env)"

bang

$ git clone https://github.com/CDSoft/bang
$ cd bang
$ ./boot.lua && ninja install
$ cd ..

Calculadoira

$ git clone https://github.com/CDSoft/calculadoira
$ cd calculadoira
$ bang && ninja install
$ cd ..

lsvg

$ git clone https://github.com/CDSoft/lsvg
$ cd lsvg
$ bang && ninja install
$ cd ..

tagref

$ git clone https://github.com/CDSoft/tagref
$ cd tagref
$ bang && ninja install
$ cd ..

ypp

$ git clone https://github.com/CDSoft/ypp
$ cd ypp
$ bang && ninja install
$ cd ..

panda

$ git clone https://github.com/CDSoft/panda
$ cd panda
$ bang && ninja install
$ cd ..

LuaX light

The light LuaX archives contain LuaX binaries and some tools written in LuaX:

• LuaX: Lua interpreter and REPL based on Lua 5.4, augmented with some useful packages. luax can also produce executable scripts from Lua scripts
• bang: Ninja file generator scriptable in LuaX
• Calculadoira: simple yet powerful calculator
• lsvg: Lua interpreter specialized to generate SVG images
• tagref: maintain cross-references in your code.
• ypp: generic text preprocessor with macro implemented in LuaX
• panda: Pandoc Lua filter that works on internal Pandoc’s AST

This command detects the OS and installs LuaX in $PREFIX/bin and $PREFIX/lib (the default prefix is ~/.local/bin and ~/.local/lib):

curl https://cdelord.fr/pub/luax.sh | sh

If you want to install a specific version (e.g. binaries statically linked with musl or if you are on Windows), just pick the right command or archive here:

LuaX full

The full LuaX archives contain the same softwares than the light archives plus some heavier but super useful programs:

• Pandoc: universal document converter
• Typst: compose papers faster, focus on your text and let Typst take care of layout and formatting

This command detects the OS and installs LuaX in $PREFIX/bin and $PREFIX/lib (the default prefix is ~/.local/bin and ~/.local/lib):

curl https://cdelord.fr/pub/luax-full.sh | sh

If you want to install a specific version (e.g. binaries statically linked with musl or if you are on Windows), just pick the right command or archive here: