Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
LAGRANGE(1)							   LAGRANGE(1)

NAME
       lagrange	- a beautiful Gemini client

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

DESCRIPTION
       Lagrange	 is a graphical	client for the Gemini, Gopher, and Finger pro-
       tocols.	It offers modern conveniences familiar from web	browsers, such
       as smooth  scrolling,  inline  image  viewing,  multiple	 tabs,	visual
       themes, Unicode fonts, and bookmarks.

OPTIONS
       When multiple URLs and/or local files are specified, they are opened in
       separate	tabs.

       -d, --dump
	      Print contents of	URLs/paths to stdout and quit.

       -I, --dump-identity ARG
	      Use  identity ARG	with --dump.  ARG can be a complete or partial
	      client certificate fingerprint or	common name.

       -E, --echo
	      Print all	internal application events to stdout.	Useful for de-
	      bugging.

       --help List the available command line options.

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

       -u, --url-or-search URL | TEXT
	      Open  a  URL, or make a search query with	given text.  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  lo-
	      cation.

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

       -w, --width N
	      Set initial window width to N pixels.

   Control options:
       These  options  are  used to control the	currently running Lagrange in-
       stance via the command line.

       --close-tab
	      Close the	current	tab.

       -L, --list-tab-urls
	      Print the	URLs of	open tabs to stdout.  If the  app  isn't  run-
	      ning, nothing is printed.

       --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  ("black",  "dark",
	      "light", "white").

ENVIRONMENT
       LAGRANGE_OVERRIDE_DPI
	      Override the autodetected	screen DPI with	a user-provided	value.
	      Some window systems and/or monitors may not provide an appropri-
	      ate  DPI value, so this enables further tuning the UI scaling in
	      addition to the "UI scale	factor"	found in Preferences.

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.

       The directory contains:

       bindings.txt
	      Customized key bindings.

       bookmarks.ini
	      Bookmarks	in TOML	format.

       feeds.txt
	      State of subscribed feeds: all the known entries and latest  up-
	      date 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  de-
	      pending on MIME type.

       palette.txt
	      Colors of	the UI palette.

       prefs.cfg
	      User's  preferences.  This is a list of UI events	that gets exe-
	      cuted 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
       • Gemini	    Protocol	  Specification	     (https://gemini.circumlu-
	 nar.space/docs/specification.gmi)

       • Gempub	Specification (https://codeberg.org/oppenlab/gempub)

       • RFC   1436:   The   Internet	Gopher	 Protocol  (https://datatrack-
	 er.ietf.org/doc/html/rfc1436)

       • RFC 1288: The Finger User  Information	 Protocol  (https://datatrack-
	 er.ietf.org/doc/html/rfc1288)

SEE ALSO
       Open "about:help" in the	application to view the	complete Help page.

AUTHORS
       Jaakko Kernen (jaakko.keranen@iki.fi).

				 November 2022			   LAGRANGE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=lagrange&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help