Go to file
Takase e2a582d5fd Process API improvements (again) (#1370)
* feat(process): add push_error
* refactor(process): use push_error for better errors
* style(process): consistent error messages
* refactor(process): reimplement process.strerror() with push_error
* refactor(process): implement close_fd only once
* refactor(process): rename process_handle to process_handle_t
* fix(process): prevent errors from a NULL error message
* refactor(process): refactor push_error into 2 functions
* fix(process): fix wrong error message
* fix(process): check if push_error_string actually pushed something
* refactor(process): make error messages descriptive
* fix(process): check for empty table instead of aborting
* refactor(process): make error messages descriptive on Windows
* refactor(process): rename process_stream_handle to process_stream_t
* refactor(process): fix wrong usage of process_handle_t
* fix(process): fix wrong type name
* refactor(process): incoporate kill_list_thread into process_kill_list_t
* refactor(process): make kill_list per-state data
2023-08-07 14:50:59 +01:00
.github Build releases with Ubuntu 18.04 container (#1460) 2023-08-07 14:50:58 +01:00
data Merge carets after `doc:move-to-{previous,next}-char` (#1462) 2023-08-07 14:50:58 +01:00
docs Merge pull request #1245 from Jan200101/PR/touch-event 2022-12-21 00:13:52 +01:00
licenses Fix Project Scanning (#746) 2022-03-06 00:59:22 -05:00
resources refactor(plugin_api): move the header into include/ (#1440) 2023-08-07 14:50:58 +01:00
scripts Build releases with Ubuntu 18.04 container (#1460) 2023-08-07 14:50:58 +01:00
src Process API improvements (again) (#1370) 2023-08-07 14:50:59 +01:00
subprojects Bump version to 2.1.1 (#1284) 2022-12-28 22:03:36 -04: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 Add manifest on Windows (#1405) 2023-08-07 14:50:58 +01:00
LICENSE Added Release Workflow and Fixed some build script issues (#1013) 2022-09-25 16:59:01 -04:00
README.md Fix [build] link and add [lite] link on Overview (#1096) 2022-08-07 17:09:54 -04:00
build-packages.sh Cross compiling improvements + macOS universal binary (#1458) 2023-08-07 14:50:58 +01:00
build.lhelper Adapt build job to lhelper-2 2022-06-30 09:42:01 +02:00
changelog.md Bump version to 2.1.1 (#1284) 2022-12-28 22:03:36 -04:00
meson.build Add manifest on Windows (#1405) 2023-08-07 14:50:58 +01:00
meson_options.txt allow defining the arch tuple via meson (#1153) 2022-10-12 18:33:10 -04:00

README.md

Lite XL

CI Discord Badge Image

screenshot-dark

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

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-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.

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 -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

where <prefix> might be one of /, /usr or /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.

Installing Prebuilt

Head over to releases and download the version for your operating system.

Linux

Unzip the file and cd into the lite-xl directory:

tar -xzf <file>
cd lite-xl

To run lite-xl without installing:

cd bin
./lite-xl

To install lite-xl copy files over into appropriate directories:

mkdir -p $HOME/.local/bin && cp bin/lite-xl $HOME/.local/bin
cp -r share $HOME/.local

If $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:

xdg-desktop-menu forceupdate

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 \
          $HOME/.local/share/applications/org.lite_xl.lite_xl.desktop \
          $HOME/.local/share/metainfo/org.lite_xl.lite_xl.appdata.xml \
          $HOME/.local/share/lite-xl

Contributing

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.

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.