🌆

skyjake.fi

Lagrange

Lagrange is a cross-platform client for browsing Geminispace. 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 for hardware-accelerated graphics. OpenSSL is used for secure communications.

Features

• Beautiful typography with full Unicode support
• Autogenerated page style and Unicode icon 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 and split view
• 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 more! Open `about:help` in the app, or see help.gmi

Downloads

Prebuilt binaries are available for Windows 64-bit, macOS 10.13 or later, and Linux AppImage (x86_64 and armhf):

Mobile

Source

You can build from source on POSIX-compatible platforms:

What's new?

v1.18

• Curses-based TUI (clagrange) as an alternative to the graphical interface.
• Support for Misfin: mail identities, sending messages, "misfin://" links.
• Support for Guppy: UDP-based light-weight protocol by Dima Krasner.
• Support for Titan edit links.
• Support for Opus audio playback using libopusfile (optional dependency).
• UI navigation with the keyboard (TAB and arrow keys).
• Bookmarks updated on permanent redirections.
• Page width extends to long content lines, if the window has space.
• Manually entering uploaded file path, not just drag-and-drop.
• Pressing the Return key focuses the URL field.
• Updated fonts and UI icons.
• Bug fixes: spurious Titan requests on navigation/restore; default Titan identity; Gophermap formatting; various minor issues.
• (v1.18.1) External Misfin URI handling. Bug fixes: garbled TUI output; issue with static linking.
• (v1.18.2) New Misfin URI format. Increased number of concurrent feed refresh requests. Bug fixes: potential crash during feed refresh; TUI drawing and behavior glitches.
• (v1.18.3) Fixed TUI background color in reduced color modes.
• (v1.18.4) Added: option to control page width expansion caused by wide content lines; audio player shows progress as bytes downloaded; clean up newlines in pasted content. Bug fixes: non-Gemini search URLs; URL path parsing error; possible TUI launch crash.
• (v1.18.5) Bug fixes: potential crash when accessing a bookmarked page; clean link icon area when switching numbering mode; potential hang when caching U+FDFD character; widget focus border in empty lists.

Feedback

If you have questions, comments or improvement ideas, you can reach me via:

Known issues

Flatpak

Flatpak applications run in a sandbox that limits their access to the rest of the system. At the moment, Lagrange has not been fully adapted to use Flatpak Portal APIs, so the following are known issues:

• Unable to open HTTP/HTTPS links via the default browser.
• Multiple instances of the application overwrite each other's data.

Wayland

The environment variable `SDL_VIDEODRIVER=wayland` can be used to force SDL to use Wayland instead of X11. However, SDL does not have full support for Wayland at the moment. You should set the Lagrange CMake build option ENABLE_POPUP_MENUS to NO. If there are issues with resizing windows, also set ENABLE_RESIZE_DRAW to NO.

Documentation and tutorials

The repository README details the basic build steps, configuration options, and has a few platform-specific notes.

A thorough walkthrough of how to upload text and files via Titan using the (beta) version of Lagrange on an iPhone.

See also