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       -d, --dump
22              Print contents of URLs/paths to stdout and quit.
23
24       -I, --dump-identity ARG
25              Use  identity ARG with --dump.  ARG can be a complete or partial
26              client certificate fingerprint or common name.
27
28       -E, --echo
29              Print all internal application events to stdout.  Useful for de‐
30              bugging.
31
32       --help List the available command line options.
33
34       --replace-tab URL
35              Open  a URL, replacing contents of the active tab.  Without this
36              option, any URLs on the command line are opened in new tabs.
37
38       -u, --url-or-search URL | TEXT
39              Open a URL, or make a search query with given text.   This  only
40              works if the search query URL has been configured.
41
42       -U, --user DIR
43              Store  user data in the directory DIR instead of the default lo‐
44              cation.
45
46       -V, --version
47              Output the version number.
48
49   Window options:
50       -h, --height N
51              Set initial window height to N pixels.
52
53       --sw   Disable hardware-accelerated rendering.
54
55       -w, --width N
56              Set initial window width to N pixels.
57
58   Control options:
59       These options are used to control the currently  running  Lagrange  in‐
60       stance via the command line.
61
62       --close-tab
63              Close the current tab.
64
65       -L, --list-tab-urls
66              Print  the  URLs  of open tabs to stdout.  If the app isn’t run‐
67              ning, nothing is printed.
68
69       --new-tab [URL]
70              Open a new tab.  If the URL  argument  is  omitted,  the  user’s
71              homepage is opened.
72
73       --tab-url
74              Print the URL of the active tab.
75

ENVIRONMENT

77       LAGRANGE_OVERRIDE_DPI
78              Override the autodetected screen DPI with a user-provided value.
79              Some window systems and/or monitors may not provide an appropri‐
80              ate  DPI value, so this enables further tuning the UI scaling in
81              addition to the “UI scale factor” found in Preferences.
82

FILES

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

STANDARDS

144       • Gemini      Protocol      Specification     (https://gemini.circumlu‐
145         nar.space/docs/specification.gmi)
146
147       • Gempub Specification (https://codeberg.org/oppenlab/gempub)
148
149       • RFC  1436:   The   Internet   Gopher   Protocol   (https://datatrack‐
150         er.ietf.org/doc/html/rfc1436)
151
152       • RFC  1288:  The  Finger User Information Protocol (https://datatrack‐
153         er.ietf.org/doc/html/rfc1288)
154

AUTHORS

159       Jaakko Keränen (jaakko.keranen@iki.fi).
160
161
162
163                                 November 2022                     LAGRANGE(1)