|George Sokianos 6807a8e29a
A lightweight text editor written in Lua, adapted from lite.
- Get Lite XL — Download for Windows, Linux and Mac OS.
- Get plugins — Add additional functionality, adapted for Lite XL.
- Get color themes — Add additional colors themes.
Lite XL has support for high DPI display on Windows and Linux and, since 1.16.7 release, it supports retina displays on macOS.
Please note that Lite XL is compatible with lite for most plugins and all color themes. We provide a separate lite-xl-plugins repository for Lite XL, because in some cases some adaptations may be needed to make them work better with Lite XL. The repository with modified plugins is https://github.com/lite-xl/lite-xl-plugins.
The changes and differences between Lite XL and rxi/lite are listed in the changelog.
Lite XL is derived from lite. It is a lightweight text editor written mostly in Lua — it aims to provide something practical, pretty, small and fast easy to modify and extend, or to use without doing either.
The aim of Lite XL compared to lite is to be more user friendly, improve the quality of font rendering, and reduce CPU usage.
Additional color themes can be found in the colors repository. These color themes are bundled with all releases of Lite XL by default.
Quick Build Guide
If you compile Lite XL yourself, it is recommended to use the script
bash build-packages.sh -h
The script will run Meson and create a tar compressed archive with the application or, for Windows, a zip file. Lite XL can be easily installed by unpacking the archive in any directory of your choice.
Otherwise the following is an example of basic commands if you want to customize the build:
meson setup --buildtype=release --prefix <prefix> build
meson compile -C build
DESTDIR="$(pwd)/lite-xl" meson install --skip-subprojects -C build
<prefix> might be one of
/opt, the default is
To build a bundle application on macOS:
meson setup --buildtype=release --Dbundle=true --prefix / build
meson compile -C build
DESTDIR="$(pwd)/Lite XL.app" meson install --skip-subprojects -C build
Please note that the package is relocatable to any prefix and the option prefix affects only the place where the application is actually installed.
Head over to releases and download the version for your operating system.
Lite XL comes with installers on Windows for typical installations. Alternatively, we provide ZIP archives that you can download and extract anywhere and run directly.
To make Lite XL portable (e.g. running Lite XL from a thumb drive),
simply create a
user folder where
lite-xl.exe is located.
Lite XL will load and store all your configurations and plugins in the folder.
We provide DMG files for macOS. Simply drag the program into your Applications folder.
Important Newer versions of Lite XL are signed with a self-signed certificate, so you'll have to follow these steps when running Lite XL for the first time.
- Find Lite XL in Finder (do not open it in Launchpad).
- Control-click Lite XL, then choose
Openfrom the shortcut menu.
Openin the popup menu.
The correct steps may vary between macOS versions, so you should refer to the macOS User Guide.
On an older version of Lite XL, you will need to run these commands instead:
# clears attributes from the directory xattr -cr /Applications/Lite\ XL.app
Otherwise, macOS will display a very misleading error saying that the application is damaged.
Unzip the file and
cd into the
tar -xzf <file>
To run lite-xl without installing:
To install lite-xl copy files over into appropriate directories:
rm -rf $HOME/.local/share/lite-xl $HOME/.local/bin/lite-xl
mkdir -p $HOME/.local/bin && cp lite-xl $HOME/.local/bin/
mkdir -p $HOME/.local/share/lite-xl && cp -r data/* $HOME/.local/share/lite-xl/
$HOME/.local/bin is not in PATH:
echo -e 'export PATH=$PATH:$HOME/.local/bin' >> $HOME/.bashrc
To get the icon to show up in app launcher:
You may need to logout and login again to see icon in app launcher.
To uninstall just run:
rm -f $HOME/.local/bin/lite-xl
rm -rf $HOME/.local/share/icons/hicolor/scalable/apps/lite-xl.svg \
Any additional functionality that can be added through a plugin should be done as a plugin, after which a pull request to the Lite XL plugins repository can be made.
Pull requests to improve or modify the editor itself are welcome.
This project is free software; you can redistribute it and/or modify it under the terms of the MIT license. See LICENSE for details.
See the licenses file for details on licenses used by the required dependencies.