LAGRANGE(1)

📦 version 1.21.2, in alpine 3.24, epel 10, epel 9, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

✨ LAGRANGE 💖 (that's the lagrange(1) manual page, bestie)

okay so. welcome to the group chat. we're talking about Lagrange, and she is that girl. 💅

🌸 NAME 🌸

lagrange — a beautiful Gemini client. yes. beautiful is literally in the name of the thing. she's iconic like that. ✨

🦋 SYNOPSIS 🦋

lagrange [options] [URL]... [FILE]...

💜 DESCRIPTION 💜

so. Lagrange is a graphical client for the Gemini, Gopher, and Finger protocols. yes, all three. she's versatile, she's multi-talented, she contains multitudes. 🫶

and the way she gives you modern conveniences you already know and love from web browsers?? literally obsessed:

  • smooth scrolling 🌊
  • inline image viewing 🖼️
  • multiple tabs 🗂️
  • visual themes 🎨
  • Unicode fonts 🔤
  • bookmarks 🔖

she ate and left no crumbs. periodt. 👑

🎀 OPTIONS 🎀

quick thing before we get into the list, because it matters:

when multiple URLs and/or local files are specified, they are opened in separate tabs. so yes, you can just dump a whole pile of links on her and she'll handle it. multitasking queen. 💖
  • -d, --dump — print contents of URLs/paths to stdout and quit. like, she reads it, she shows you, she leaves. no small talk. 😌
  • -I, --dump-identity ARG — use identity ARG with --dump. ARG can be a complete or partial client certificate fingerprint or common name. (certificate vibes 🔐)
  • -E, --echo — print all internal application events to stdout. useful for debugging. she's telling you everything, bestie, every little thought. 🙈
  • --help — list the available command line options. the classic. the icon. 🌟
  • --replace-tab URL — open a URL, replacing contents of the active tab. without this option, any URLs on the command line are opened in new tabs. (so this one is the "no new tab, we're swapping" girlie)
  • -u, --url-or-search URL | TEXT — open a URL, or make a search query with given text. heads up tho: this only works if the search query URL has been configured. 🔍
  • -U, --user DIR — store user data in the directory DIR instead of the default location. your stuff, your rules. 💅
  • -V, --version — output the version number. 📌

🪟 Window options:

  • -h, --height N — set initial window height to N pixels. 📏
  • --prefs-sheet — open Preferences as a sheet inside the active window.
  • --sw — disable hardware-accelerated rendering. (software mode, we love a fallback 💀)
  • -w, --width N — set initial window width to N pixels. 📐

🎛️ Control options:

these ones are a whole different energy, okay? so:

These options are used to control the currently running Lagrange instance via the command line. like, you're not launching a new girl, you're texting the one who's already at the party. 📱
  • --close-tab — close the current tab. bye bestie 👋
  • -L, --list-tab-urls — print the URLs of open tabs to stdout. if the app isn't running, nothing is printed. (she's not gonna answer if she's not there, fr fr)
  • --new-tab [URL] — open a new tab. if the URL argument is omitted, the user's homepage is opened. 🏠
  • --tab-url — print the URL of the active tab. 🎯
  • -t, --theme [ARG] — change the current UI color theme to ARG. the options are "black", "dark", "light", "white". 🌈 (four aesthetics, pick your era)

🌈 ENVIRONMENT 🌈

  • LAGRANGE_OVERRIDE_DPI — override the autodetected screen DPI with a user-provided value. why does this exist? because some window systems and/or monitors may not provide an appropriate DPI value, so this enables further tuning the UI scaling in addition to the "UI scale factor" found in Preferences. so you've got two knobs, use them wisely. 🔧

🗂️ FILES 🗂️

user-specific files such as bookmarks and navigation history are stored in the following operating system dependent locations:

  • Windows: C:\Users\Name\AppData\Roaming\fi.skyjake.Lagrange
  • macOS: ~/Library/Application Support/fi.skyjake.Lagrange
  • Other: ~/.config/lagrange
use the --user option to store user data in a custom location. 🫶

and the directory contains... deep breath... all of this:

  • bindings.txt — customized key bindings. ⌨️
  • bookmarks.ini — bookmarks in TOML format. 🔖
  • feeds.txt — state of subscribed feeds: all the known entries and latest update timestamps. 📡
  • fonts.ini — custom fonts to load at launch. 🔤
  • idents.lgr — information about identities. 🪪
  • idents/ — subdirectory containing client certificates and private keys in PEM format. 🔐
  • modmap.txt — customized keyboard modifier mapping.
  • mimehooks.txt — configuration of external programs to filter page contents depending on MIME type. 🧪
  • palette.txt — colors of the UI palette. 🎨
  • prefs.cfg — user's preferences. this is a list of UI events that gets executed at launch (cf. output of --echo). ⚙️
  • state.lgr — serialized UI state, specifying open tabs and sidebar state. 🗂️
  • sitespec.ini — site-specific preferences in TOML format.
  • trusted.2.txt — fingerprints of trusted server certificates. 🤝
  • visited.2.txt — list of visited URLs with timestamps. ⏰

⭐ STANDARDS ⭐

she follows the rules, she respects the specs, she does her homework:

👀 SEE ALSO 👀

open about:help in the application to view the complete Help page. yes, in the app. that's where the full lore lives. 📖

💖 AUTHORS 💖

Jaakko Keränen (jaakko.keranen@iki.fi). thank you for the gift, king. 🙏✨

one last vibe check, bestie 🌈 this whole page is from November 2022, and it's page one of the LAGRANGE(1) manual — so if you ever forget any of this, just know she's documented, she's dated, and she's slaying. mwah. 💋

no cap, that's the whole page. go open a tab. 🦋💜

📦 where this page comes from