lagrange(1)

1LAGRANGE(1)                                                        LAGRANGE(1)
2
3
4

NAME

6       lagrange - a beautiful Gemini client
7

SYNOPSIS

9       lagrange [options] [URL]... [FILE]...
10

DESCRIPTION

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

OPTIONS

18       When multiple URLs and/or local files are specified, they are opened in
19       separate tabs.
20
21       -E, --echo
22              Print all internal application events to stdout.  Useful for de‐
23              bugging.
24
25       --help List the available command line options.
26
27       -u, --url-or-search URL | TEXT
28              Open a URL, or make a search query with given text.   This  only
29              works if the search query URL has been configured.
30
31       -V, --version
32              Output the version number.
33
34   Window options:
35       -h, --height N
36              Set initial window height to N pixels.
37
38       --sw   Disable hardware-accelerated rendering.
39
40       -w, --width N
41              Set initial window width to N pixels.
42
43   Control options:
44       These  options  are  used to control the currently running Lagrange in‐
45       stance via the command line.
46
47       --close-tab
48              Close the current tab.
49
50       -L, --list-tab-urls
51              Print the URLs of open tabs to stdout.  If the  app  isn’t  run‐
52              ning, nothing is printed.
53
54       --new-tab [URL]
55              Open  a  new  tab.   If  the URL argument is omitted, the user’s
56              homepage is opened.
57
58       --tab-url
59              Print the URL of the active tab.
60

ENVIRONMENT

62       LAGRANGE_OVERRIDE_DPI
63              Override the autodetected screen DPI with a user-provided value.
64              Some window systems and/or monitors may not provide an appropri‐
65              ate DPI value, so this enables further tuning the UI scaling  in
66              addition to the “UI scale factor” found in Preferences.
67

FILES

69       User-specific files such as bookmarks and navigation history are stored
70       in the following operating system dependent locations:
71
72       • Windows: “C:\Users\Name\AppData\Roaming\fi.skyjake.Lagrange”
73
74       • macOS: “~/Library/Application Support/fi.skyjake.Lagrange”
75
76       • Other: “~/.config/lagrange”
77
78       The directory contains:
79
80       bindings.txt
81              Customized key bindings.
82
83       bookmarks.ini
84              Bookmarks in TOML format.
85
86       feeds.txt
87              State of subscribed feeds: all the known entries and latest  up‐
88              date timestamps.
89
90       fonts.ini
91              Custom fonts to load at launch.
92
93       idents.lgr
94              Information about identities.
95
96       idents/
97              Subdirectory  containing client certificates and private keys in
98              PEM format.
99
100       modmap.txt
101              Customized keyboard modifier mapping.
102
103       mimehooks.txt
104              Configuration of external programs to filter page  contents  de‐
105              pending on MIME type.
106
107       palette.txt
108              Colors of the UI palette.
109
110       prefs.cfg
111              User’s  preferences.  This is a list of UI events that gets exe‐
112              cuted at launch (cf. output of --echo).
113
114       state.lgr
115              Serialized UI state, specifying open tabs and sidebar state.
116
117       sitespec.ini
118              Site-specific preferences in TOML format.
119
120       trusted.2.txt
121              Fingerprints of trusted server certificates.
122
123       visited.2.txt
124              List of visited URLs with timestamps.
125

STANDARDS

127       • Gemini     Protocol      Specification      (https://gemini.circumlu‐
128         nar.space/docs/specification.gmi)
129
130       • Gempub Specification (https://codeberg.org/oppenlab/gempub)
131
132       • RFC   1436:   The   Internet   Gopher   Protocol  (https://datatrack‐
133         er.ietf.org/doc/html/rfc1436)
134
135       • RFC 1288: The Finger User  Information  Protocol  (https://datatrack‐
136         er.ietf.org/doc/html/rfc1288)
137

AUTHORS

142       Jaakko Keränen (jaakko.keranen@iki.fi).
143
144
145
146                                 January 2022                      LAGRANGE(1)