[1mdiff --git a/CMakeLists.txt b/CMakeLists.txt[m
[1mindex 2f53628d..f2b1e070 100644[m
[1m--- a/CMakeLists.txt[m
[1m+++ b/CMakeLists.txt[m
[36m@@ -74,10 +74,10 @@[m [moption (ENABLE_FRIBIDI_BUILD "Build the GNU FriBidi library (if OFF, try pkg-[m
option (ENABLE_HARFBUZZ "Use the HarfBuzz library to shape text" ON)[m
option (ENABLE_HARFBUZZ_MINIMAL "Build the HarfBuzz library with minimal dependencies (if OFF, try pkg-config)" OFF)[m
option (ENABLE_MPG123 "Use mpg123 for decoding MPEG audio" ON)[m
[32m+[m[32moption (ENABLE_OPUS "Use llibopusfile for decoding Opus audio (via pkg-config)" ON)[m
option (ENABLE_SPARKLE "Use Sparkle for automatic updates (macOS)" OFF)[m
option (ENABLE_WEBP "Use libwebp to decode .webp images (via pkg-config)" ON)[m
option (ENABLE_WINSPARKLE "Use WinSparkle for automatic updates (Windows)" OFF)[m
[31m-option (ENABLE_OPUS "Use llibopusfile for decoding Opus audio (via pkg-config)" ON)[m
[m
include (BuildType)[m
include (Resources)[m
[1mdiff --git a/README.md b/README.md[m
[1mindex b4cdf404..c7923130 100644[m
[1m--- a/README.md[m
[1m+++ b/README.md[m
[36m@@ -15,6 +15,7 @@[m [mLike Gemini, Lagrange has been designed with minimalism in mind. It depends on a[m
[32m+[m[32m* Curses-based TUI as an alternative to the graphical interface[m
about:help in the app, or see help.gmi[m[m
[36m@@ -46,7 +47,7 @@[m [mYou need a POSIX-compatible environment to compile Lagrange.[m
The required tools are a C11 compiler (e.g., Clang or GCC), CMake, pkg-config, and zip. Additional tools are required if HarfBuzz and GNU FriBidi are also compiled as part of the build (see next section for details).[m
[m
git clone --recursive --branch release https://git.skyjake.fi/gemini/lagrange[m[31m-2. Check that you have the recommended build tools and dependencies installed: SDL 2, OpenSSL 1.1.1, libpcre, libunistring, GNU FriBidi, and zlib. For example,[m
[32m+[m[32m2. Check that you have the recommended build tools and dependencies installed: SDL 2, OpenSSL, libpcre, libunistring, GNU FriBidi, and zlib. For example,[m
* on macOS using Homebrew: `brew install cmake automake sdl2 openssl@1.1 pcre libunistring fribidi`[m
* on Ubuntu: `sudo apt install cmake zip libsdl2-dev libssl-dev libpcre3-dev zlib1g-dev libunistring-dev libfribidi-dev`[m
* on Fedora: `sudo dnf install cmake zip SDL2-devel openssl-devel pcre-devel zlib-devel libunistring-devel fribidi-devel`[m
[36m@@ -86,6 +87,7 @@[m [mNote that the install target also deploys an XDG .desktop file for launching t[m
| ------------ | ----------- |[m
| ENABLE_CUSTOM_FRAME | Draw a custom window frame. (Only on Microsoft Windows.) The custom frame is more in line with the visual style of the rest of the UI, but does not implement all of the native window behaviors (e.g., snapping, system menu). |[m
| ENABLE_DOWNLOAD_EDIT | Allow changing the Downloads directory via the Preferences dialog. This should be set to OFF in sandboxed environments where downloaded files must be saved into a specific place. |[m
[32m+[m[32m| ENABLE_GUI | Build the GUI application (the default). |[m
| ENABLE_IDLE_SLEEP | Sleep in the main thread instead of waiting for events. On some platforms, when using SDL 2.0.16 or earlier, SDL_WaitEvent() may have a relatively high CPU usage. Setting this to ON polls for events periodically but otherwise keeps the main thread sleeping, reducing CPU usage. The drawback is that there is a slightly increased latency reacting to new events after idle mode ends. |[m
| ENABLE_FRIBIDI | Use the GNU FriBidi library for processing bidirectional text. FriBidi implements the Unicode Bidirectional Algorithm to determine text directions. |[m
| ENABLE_FRIBIDI_BUILD | Compile the GNU FriBidi library as part of the build. If set to OFF, pkg-config is used instead to locate the library. |[m
[36m@@ -93,24 +95,27 @@[m [mNote that the install target also deploys an XDG .desktop file for launching t[m
| ENABLE_HARFBUZZ_MINIMAL | Build the HarfBuzz library with all dependencies disabled. Useful when building the app for distribution so that the number of deployed dependencies will be minimized. A system-provided version of HarfBuzz is likely built with dependencies on FreeType and ICU at least. If set to OFF, pkg-config will be used to find HarfBuzz. | [m
| ENABLE_IPC | Instances of the Lagrange executable communicate via signals or (on Windows) a system-provided IPC mechanism. This is used for controlling an existing Lagrange window via the CLI. If set to OFF, each instance of the app runs without knowledge of other instances. This may cause them to overwrite each other's runtime files. |[m
| ENABLE_KERNING | Use kerning information in the fonts to adjust glyph placement. Setting this ON improves text appearance in subtle ways but slows down text rendering. It may be a good idea to set this to OFF when running on a slow CPU. This option only affects the simple built-in text renderer, and has no effect on HarfBuzz. |[m
[32m+[m[32m| ENABLE_MOBILE_PHONE | Use the mobile phone UI variant. This replaces the sidebars with a sliding sheet and has other touch-friendly features. Settings and dialogs are presented as form-based sheets. |[m
[32m+[m[32m| ENABLE_MOBILE_TABLET | Use the tablet UI variant. Sidebars are available as on the desktop, but Settings and dialogs are presented as form-based sheets. |[m
| ENABLE_MPG123 | Use the mpg123 library for decoding MPEG audio files. |[m
[32m+[m[32m| ENABLE_OPUS | Use the opusfile library for decoding Opus audio files. |[m
| ENABLE_RELATIVE_EMBED | Locate resources only in relation to the executable. Useful when any system/predefined directories are not supposed to be accessed, e.g., in the Windows portable build. |[m
[31m-| ENABLE_TUI | Build the TUI version (clagrange). The SEALCurses library is required: it is used instead of SDL. |[m
[32m+[m[32m| ENABLE_STATIC | Link dependencies statically. |[m
[32m+[m[32m| ENABLE_TUI | Build the TUI application (clagrange). The SEALCurses library is required (it replaces SDL); check that the lib/sealcurses submodule is checked out. |[m
| ENABLE_WEBP | Use libwebp to decode .webp images, if pkg-config can find the library. |[m
| ENABLE_WINDOWPOS_FIX | Set correct window position after the window has already been shown. This may be necessary on some platforms to prevent the window from being restored to the wrong position. |[m
| ENABLE_X11_SWRENDER | Default to software rendering when running under X11. By default Lagrange attempts to use the GPU for rendering the user interface. You can also use the --sw option at launch to force software rendering. |[m
[32m+[m[32m| ENABLE_X11_XLIB | Use the Xlib API directly under X11. This is used for window decoration color theming, for example. |[m
[m
[m
[31m-Lagrange has an optional text-mode interface that enables running the app in the terminal. This is disabled by the default build settings. Setting the ENABLE_TUI option to YES will replace the SDL dependency with a library called SEALCurses that implements the required parts of the SDL API on top of Curses. The resulting executable is called clagrange.[m
[32m+[m[32mLagrange has a text-mode interface that enables running the app in a terminal. However, it is mutually exclusive with the graphical interface, which means that the GUI and TUI are built as separate executables. By default, the TUI is disabled in the build settings. Set the ENABLE_TUI option to YES to build the TUI executable. If the GUI is not needed, you can also set ENABLE_GUI to NO. The TUI executable is called clagrange.[m
[m
[31m-The requirements for building the TUI version are the same as with the GUI, except ncurses is required instead of SDL. HarfBuzz and all the image and audio dependencies are excluded from the TUI build.[m
[31m-[m
[31m-The build-tui.sh helper script is provided for building the TUI version. All command line arguments given to the script are passed to CMake for further configuring the build. Note that the CMake install prefix variable (CMAKE_INSTALL_PREFIX) should not be set via an argument. Instead, the script will prompt for the install directory when run.[m
[32m+[m[32mIn the TUI build, SDL is replaced with a library called SEALCurses that implements a subset of the SDL API on top of Curses. The requirements for building the TUI are otherwise the same as with the GUI, except HarfBuzz, FriBidi, and all the image and audio dependencies will not be used.[m
[m
[m
[31m-When using OpenSSL 1.1.1 from Homebrew, you must add its pkgconfig path to your PKG_CONFIG_PATH environment variable, for example:[m
[32m+[m[32mWhen using OpenSSL from Homebrew, you must add its pkgconfig path to your PKG_CONFIG_PATH environment variable, for example:[m
[m
export PKG_CONFIG_PATH=/opt/homebrew/Cellar/openssl@1.1/1.1.1i/lib/pkgconfig[m
[m
text/plainThis content has been proxied by September (3851b).