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       --prefs-sheet
54              Open Preferences as a sheet inside the active window.
55
56       --sw   Disable hardware-accelerated rendering.
57
58       -w, --width N
59              Set initial window width to N pixels.
60
61   Control options:
62       These options are used to control the currently  running  Lagrange  in‐
63       stance via the command line.
64
65       --close-tab
66              Close the current tab.
67
68       -L, --list-tab-urls
69              Print  the  URLs  of open tabs to stdout.  If the app isn’t run‐
70              ning, nothing is printed.
71
72       --new-tab [URL]
73              Open a new tab.  If the URL  argument  is  omitted,  the  user’s
74              homepage is opened.
75
76       --tab-url
77              Print the URL of the active tab.
78

ENVIRONMENT

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

FILES

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

STANDARDS

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

AUTHORS

162       Jaakko Keränen (jaakko.keranen@iki.fi).
163
164
165
166                                 November 2022                     LAGRANGE(1)