Lagrange

Lagrange is a cross-platform client for browsing Geminispace (opens in a new tab). It offers modern conveniences familiar from web browsers, such as smooth scrolling, inline image viewing, multiple tabs, visual themes, Unicode fonts, bookmarks, history, and page outlines.

Like Gemini, Lagrange has been designed with minimalism in mind. It depends on a small number of essential libraries. It is written in C and uses SDL (opens in a new tab) for hardware-accelerated graphics. OpenSSL (opens in a new tab) is used for secure communications.

Features

• Beautiful typography with full Unicode support
• Autogenerated page style and symbol for each Gemini domain
• Smart suggestions when typing the URL — search bookmarks, history, identities
• Sidebar for page outline, managing bookmarks and identities, and viewing history
• Multiple tabs
• Identity management — create and use TLS client certificates
• Audio playback: MP3, Ogg Vorbis, WAV
• Curses-based TUI as an alternative to the graphical interface
• And much more! Open about:help in the app, or see help.gmi (opens in a new tab)

How to compile

You need a POSIX-compatible environment to compile Lagrange.

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

• Download and extract a source tarball from [Releases][rel]. Please note that the GitHub/Gitea-generated tarballs do not contain HarfBuzz, GNU FriBidi, or the_Foundation (opens in a new tab) submodules; check which tarball you are downloading. Alternatively, you may also clone the repository and its submodules: git clone --recursive --branch release https://git.skyjake.fi/gemini/lagrange
• Check that you have the build tools and dependencies installed: SDL (2.0.8 or newer), OpenSSL, libpcre, libunistring, GNU FriBidi, and zlib. For example,
• on macOS using Homebrew: brew install cmake automake sdl2 openssl@1.1 pcre libunistring fribidi
• on Ubuntu: sudo apt install cmake zip libsdl2-dev libssl-dev libpcre3-dev zlib1g-dev libunistring-dev libfribidi-dev
• on Fedora: sudo dnf install cmake zip SDL2-devel openssl-devel pcre-devel zlib-devel libunistring-devel fribidi-devel
• Optionally, install the mpg123 decoder library for MPEG audio support. For example, the macOS Homebrew package is mpg123, on Ubuntu it is libmpg123-dev, and on Fedora it is mpg123-devel.