Go to file
Francesco Abbate a134c8ea99 Add missing release flag in build-packages.sh 2021-09-03 23:33:36 +02:00
.github GitHub Actions builds and deployment 2021-08-13 16:24:53 +02:00
data Add a simple cache to `DocView:get_h_scrollable_size` 2021-09-03 00:55:10 +02:00
docs Namespaced aliases, virtual classes and added missing returns. 2021-07-09 18:33:25 -04:00
lib/font_renderer Avoid having no `pixel_width` 2021-08-28 09:59:36 +02:00
licenses Moved documentation to the website repository, updated README (#247) 2021-06-03 18:57:26 +02:00
resources Update meson.build 2021-09-03 14:36:36 +02:00
scripts Renamed freedesktop resources 2021-08-31 20:19:40 +02:00
src Fix macOS build issue with recent commit 2021-08-19 14:33:39 -07:00
subprojects Reference latest reproc subproject version 2021-08-16 11:54:25 +02:00
.editorconfig Updated Meson configuration 2021-08-09 22:26:16 +02:00
.gitattributes Merge pull request #309 from redtide/git-line-endings 2021-06-30 11:13:42 -04:00
.gitignore CI and custom build script utilities 2021-08-12 22:07:38 +02:00
LICENSE Switch to FiraSans and JetBrainsMono fonts 2021-05-22 15:09:54 +02:00
README.md Added GH Actions CI badge on README.md 2021-08-16 15:47:11 +02:00
build-packages.sh Add missing release flag in build-packages.sh 2021-09-03 23:33:36 +02:00
changelog.md 2.0 changelog and modversion updates. 2021-08-17 20:24:44 +02:00
meson.build Update meson.build 2021-09-03 14:36:36 +02:00
meson_options.txt Fix macOS build issue with recent commit 2021-08-19 14:33:39 -07:00

README.md

Lite XL

CI Discord Badge Image

screenshot-dark

A lightweight text editor written in Lua, adapted from lite.

  • Get Lite XL — Download for Windows, Linux and Mac OS (notarized app).
  • Get plugins — Add additional functionality, adapted for Lite XL.
  • Get color themes — Add additional colors themes.

Please refer to our website for the user and developer documentation, including build instructions details. A quick build guide is described below.

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-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/franko/lite-plugins.

The changes and differences between Lite XL and rxi/lite are listed in the changelog.

Overview

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.

Customization

Additional functionality can be added through plugins which are available in the plugins repository or in the Lite XL plugins repository.

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 build-packages.sh:

bash build-packages.sh <arch>

The script will run Meson and create a zip file with the application or, for Linux, a tar compressed archive. 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

where <prefix> might be one of /, /usr or /opt, the default is /usr/local. Please note that the package is relocatable to any prefix and the option prefix affects only the place where the application is actually installed.

Contributing

Any additional functionality that can be added through a plugin should be done as a plugin, after which a pull request to the plugins repository can be made.

If the plugin uses any Lite XL-specific functionality, please open a pull request to the Lite XL plugins repository.

Pull requests to improve or modify the editor itself are welcome.

Licenses

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.