Skip to content

Installation

Kevin edited this page Aug 12, 2026 · 7 revisions

LuaRocks

luarocks install astal

Arch Linux

paru -S libastal-git libastal-4-git gtk3 gtk4 libastal-lua-git

From source

  1. Set up a local Lua/LuaRocks environment with Hererocks:
hererocks venv --lua 5.1 --luarocks ^
source venv/bin/activate
  1. Install the required dependencies on your system:

    • libastal-git
    • libastal-4-git
    • gtk3
    • gtk4
  2. Clone the repository:

git clone https://github.com/tokyob0t/astal-lua.git
cd astal-lua
  1. Build:
luarocks --lua-version=5.4 make

Tip

LGI is officially supported and can be used to interact with GTK from Lua. However, LuaGObject is recommended, as it provides better bindings and a more modern interface for working with GObject-based libraries such as Gtk-4.0 and Adw-1.

Clone this wiki locally