1 cc9bf8f2 2021-11-05 op TELESCOPE(1) General Commands Manual TELESCOPE(1)
4 cc9bf8f2 2021-11-05 op telescope multi-protocol browser
7 cc9bf8f2 2021-11-05 op telescope [-Chnv] [-c config] [URL]
10 cc9bf8f2 2021-11-05 op telescope is an interactive browser that supports the Finger, Gemini and
11 cc9bf8f2 2021-11-05 op Gopher protocols. telescope features tabs, a minibuffer, interactive
12 cc9bf8f2 2021-11-05 op completions, bookmarks and out-of-band TOFU verification.
14 cc9bf8f2 2021-11-05 op The arguments are as follows:
16 cc9bf8f2 2021-11-05 op -C, --colors Show all available colors and exit.
18 cc9bf8f2 2021-11-05 op -c config Specify an alternative configuration file. By default
19 cc9bf8f2 2021-11-05 op $HOME/.telescope/config is loaded.
21 cc9bf8f2 2021-11-05 op -h, --help Display version and usage.
23 cc9bf8f2 2021-11-05 op -n Configtest mode. Only check the configuration file for
26 cc9bf8f2 2021-11-05 op -v, --version Display version.
29 cc9bf8f2 2021-11-05 op telescope interface is divided into four areas: the tabline, the body,
30 cc9bf8f2 2021-11-05 op the modeline and the echoarea/minibuffer.
32 cc9bf8f2 2021-11-05 op The tabline is always at the top of the screen and displays the tabs
33 cc9bf8f2 2021-11-05 op separated by a vertical line. When there are more tabs than the size of
34 cc9bf8f2 2021-11-05 op the window allow to display, the characters < or > are shown at the
35 cc9bf8f2 2021-11-05 op start/end of the tabline to indicate that there are more tabs in that
38 cc9bf8f2 2021-11-05 op The body occupies the majority of the visible area. It contains the
39 cc9bf8f2 2021-11-05 op current page and optionally a side window.
41 cc9bf8f2 2021-11-05 op The modeline is the second to last row of the screen. It shows some
42 cc9bf8f2 2021-11-05 op information about the page: a spinner when the page is loading, the trust
43 cc9bf8f2 2021-11-05 op level, the document type, the scroll offset and the URL.
45 cc9bf8f2 2021-11-05 op The echoarea is usually the last line of the screen. Messages are often
46 cc9bf8f2 2021-11-05 op showed there, and link addresses too. The echoarea is also used to
47 cc9bf8f2 2021-11-05 op obtain input from the user. When commands like swiper or link-select are
48 cc9bf8f2 2021-11-05 op invoked, the minibuffer area grows to show possible completions.
51 cc9bf8f2 2021-11-05 op telescope aims to use the Trust, but Verify (where appropriate)
52 cc9bf8f2 2021-11-05 op approach for TOFU (Trust On First Use). The idea is to define three
53 cc9bf8f2 2021-11-05 op level of verification for a certificate:
55 cc9bf8f2 2021-11-05 op untrusted (!) the server fingerprint does NOT match the stored
58 cc9bf8f2 2021-11-05 op trusted (v) the server fingerprint matches the store one.
60 cc9bf8f2 2021-11-05 op verified (V) the fingerprint matches and has been verified out-of-
63 cc9bf8f2 2021-11-05 op The trust level of the page is indicated in the modeline with the
64 cc9bf8f2 2021-11-05 op indicated character.
66 cc9bf8f2 2021-11-05 op Most of the time the trusted level is enough, but where is appropriate
67 cc9bf8f2 2021-11-05 op users should be able to verify out-of-band the certificate.
69 cc9bf8f2 2021-11-05 op At the moment, there is no built-in support for an out-of-band
70 cc9bf8f2 2021-11-05 op verification though.
72 cc9bf8f2 2021-11-05 op SUPPORTED PROTOCOLS
73 cc9bf8f2 2021-11-05 op The following protocols are supported:
75 cc9bf8f2 2021-11-05 op about: About pages are telescope internal page. See about:about for
76 cc9bf8f2 2021-11-05 op a list of all these pages.
78 cc9bf8f2 2021-11-05 op file:// File types know to telescope, such as .gmi, .gemini, .txt,
79 cc9bf8f2 2021-11-05 op .md, .markdown, .diff or .patch, can be viewed inside the
80 cc9bf8f2 2021-11-05 op application. Types of local files are detected solely based
81 cc9bf8f2 2021-11-05 op on the file extension. On some systems, such as OpenBSD, only
82 cc9bf8f2 2021-11-05 op files inside special directories (like /tmp or ~/Downloads)
83 cc9bf8f2 2021-11-05 op are available.
85 cc9bf8f2 2021-11-05 op finger:// Finger URLs are interpreted as follows:
86 cc9bf8f2 2021-11-05 op the host is determined by the host name portion of the URL
87 cc9bf8f2 2021-11-05 op if the user portion of the URL is provided, it's
88 cc9bf8f2 2021-11-05 op interpreted as the user to finger, otherwise the path
89 cc9bf8f2 2021-11-05 op component will be used
90 cc9bf8f2 2021-11-05 op thus finger://user@hostname and finger://hostname/user are
91 cc9bf8f2 2021-11-05 op treated as the same URL.
93 cc9bf8f2 2021-11-05 op gemini:// Gemini is fully supported, with the exception of client-
96 cc9bf8f2 2021-11-05 op gopher:// Gopher support is limited to items type 0, 1 and 7. All text
97 cc9bf8f2 2021-11-05 op is assumed to be encoded in UTF-8 (or ASCII).
99 cc9bf8f2 2021-11-05 op User-entered URLs, given as argument on the command line or entered with
100 cc9bf8f2 2021-11-05 op load-url, are intepreted with a simple heuristic:
101 cc9bf8f2 2021-11-05 op if it's a proper absolute URL then use it as-is,
102 cc9bf8f2 2021-11-05 op if it starts with ./ or / assume it's a file:// URL,
103 cc9bf8f2 2021-11-05 op otherwise assume it's a Gemini URL.
105 cc9bf8f2 2021-11-05 op DEFAULT KEY BINDINGS
106 cc9bf8f2 2021-11-05 op The default key bindings are very similar to GNU Emacs, but care has been
107 cc9bf8f2 2021-11-05 op taken to include also bindings familiar for vi(1) and CUA users. In
108 cc9bf8f2 2021-11-05 op the following examples, C-x means Control-x, M-x means Meta-x, where the
109 cc9bf8f2 2021-11-05 op Meta key may be either a special key on the keyboard or the ALT key;
110 cc9bf8f2 2021-11-05 op otherwise ESC followed by the key X works as well, and C-M-x means to
111 cc9bf8f2 2021-11-05 op press the key X together with both Control and Meta.
113 cc9bf8f2 2021-11-05 op Keys are usually a single character, like p or n, but some special
114 cc9bf8f2 2021-11-05 op keys are accepted as well.
116 cc9bf8f2 2021-11-05 op <up> Up arrow
117 cc9bf8f2 2021-11-05 op <down> Down arrow
118 cc9bf8f2 2021-11-05 op <left> Left arrow
119 cc9bf8f2 2021-11-05 op <right> Right arrow
120 cc9bf8f2 2021-11-05 op <prior> Previous page/Page up
121 cc9bf8f2 2021-11-05 op <next> Next page/Page down
124 cc9bf8f2 2021-11-05 op <f0> thru <f63> Function keys
125 cc9bf8f2 2021-11-05 op del or backspace Backspace
127 cc9bf8f2 2021-11-05 op space or spc Space
128 cc9bf8f2 2021-11-05 op enter or ret Enter
130 cc9bf8f2 2021-11-05 op backtab Depends on the configuration of the terminal
131 cc9bf8f2 2021-11-05 op emulator; usually shift tab.
133 cc9bf8f2 2021-11-05 op GNU Emacs-like keys
134 cc9bf8f2 2021-11-05 op C-p previous-line
135 cc9bf8f2 2021-11-05 op C-n next-line
136 cc9bf8f2 2021-11-05 op C-f forward-char
137 cc9bf8f2 2021-11-05 op C-b backward-char
138 cc9bf8f2 2021-11-05 op M-{ backward-paragraph
139 cc9bf8f2 2021-11-05 op M-} forward-paragraph
140 cc9bf8f2 2021-11-05 op C-a move-beginning-of-line
141 cc9bf8f2 2021-11-05 op C-e move-end-of-line
142 cc9bf8f2 2021-11-05 op M-v, M-space scroll-up
143 cc9bf8f2 2021-11-05 op C-v, space scroll-down
144 cc9bf8f2 2021-11-05 op M-< beginning-of-buffer
145 cc9bf8f2 2021-11-05 op M-> end-of-buffer
146 cc9bf8f2 2021-11-05 op C-x C-c kill-telescope
147 cc9bf8f2 2021-11-05 op C-g clear-minibuf
148 cc9bf8f2 2021-11-05 op M-x execute-extended-command
149 cc9bf8f2 2021-11-05 op C-c { dec-fill-column
150 cc9bf8f2 2021-11-05 op C-c } inc-fill-column
151 cc9bf8f2 2021-11-05 op C-c p previous-heading
152 cc9bf8f2 2021-11-05 op C-c n next-heading
154 cc9bf8f2 2021-11-05 op < load-current-url
155 cc9bf8f2 2021-11-05 op C-x C-f load-url
156 cc9bf8f2 2021-11-05 op C-x M-f load-current-url
157 cc9bf8f2 2021-11-05 op C-x o other-window
158 cc9bf8f2 2021-11-05 op C-x t 0 tab-close
159 cc9bf8f2 2021-11-05 op C-x t 1 tab-close-other
160 cc9bf8f2 2021-11-05 op C-x t 2 tab-new
161 cc9bf8f2 2021-11-05 op C-x t o tab-next
162 cc9bf8f2 2021-11-05 op C-x t O tab-previous
163 cc9bf8f2 2021-11-05 op C-x t m tab-move
164 cc9bf8f2 2021-11-05 op C-x t M tab-move-to
165 cc9bf8f2 2021-11-05 op B, C-M-b previous-page
166 cc9bf8f2 2021-11-05 op F, C-M-f next-page
167 cc9bf8f2 2021-11-05 op <f7> a bookmark-page
168 cc9bf8f2 2021-11-05 op <f7> <f7> list-bookmarks
169 cc9bf8f2 2021-11-05 op C-z suspend-telescope
171 cc9bf8f2 2021-11-05 op vi(1)-like keys
172 cc9bf8f2 2021-11-05 op k previous-line
174 cc9bf8f2 2021-11-05 op l forward-char
175 cc9bf8f2 2021-11-05 op h backward-char
176 cc9bf8f2 2021-11-05 op { backward-paragraph
177 cc9bf8f2 2021-11-05 op } forward-paragraph
178 cc9bf8f2 2021-11-05 op ^ move-beginning-of-line
179 cc9bf8f2 2021-11-05 op $ move-end-of-line
180 cc9bf8f2 2021-11-05 op K scroll-line-up
181 cc9bf8f2 2021-11-05 op J scroll-line-down
182 cc9bf8f2 2021-11-05 op g g beginning-of-buffer
183 cc9bf8f2 2021-11-05 op G end-of-buffer
184 cc9bf8f2 2021-11-05 op g D tab-close
187 cc9bf8f2 2021-11-05 op g T tab-previous
188 cc9bf8f2 2021-11-05 op g M-t tab-move
189 cc9bf8f2 2021-11-05 op g M-T tab-move-to
190 cc9bf8f2 2021-11-05 op H previous-page
192 cc9bf8f2 2021-11-05 op q kill-telescope
193 cc9bf8f2 2021-11-05 op ESC clear-minibuf
194 cc9bf8f2 2021-11-05 op : execute-extended-command
196 cc9bf8f2 2021-11-05 op CUA-like keys
197 cc9bf8f2 2021-11-05 op <up> previous-line
198 cc9bf8f2 2021-11-05 op <down> next-line
199 cc9bf8f2 2021-11-05 op <right> forward-char
200 cc9bf8f2 2021-11-05 op <left> backward-char
201 cc9bf8f2 2021-11-05 op <home> move-beginning-of-line
202 cc9bf8f2 2021-11-05 op <end> move-end-of-line
203 cc9bf8f2 2021-11-05 op <prior> scroll-up
204 cc9bf8f2 2021-11-05 op <next> scroll-down
205 cc9bf8f2 2021-11-05 op C-w tab-close
207 cc9bf8f2 2021-11-05 op M-<prior> tab-previous
208 cc9bf8f2 2021-11-05 op M-<next> tab-next
209 cc9bf8f2 2021-11-05 op M-<left> previous-page
210 cc9bf8f2 2021-11-05 op M-<right> next-page
211 cc9bf8f2 2021-11-05 op <f5> reload-page
212 cc9bf8f2 2021-11-05 op r reload-page
214 cc9bf8f2 2021-11-05 op Neither Emacs nor vi specific
215 cc9bf8f2 2021-11-05 op <f1> toggle-help
216 cc9bf8f2 2021-11-05 op enter push-button
217 cc9bf8f2 2021-11-05 op M-enter push-button-new-tab
218 cc9bf8f2 2021-11-05 op M-tab previous-button
219 cc9bf8f2 2021-11-05 op backtab previous-button
220 cc9bf8f2 2021-11-05 op tab next-button
221 cc9bf8f2 2021-11-05 op M-t tab-select
222 cc9bf8f2 2021-11-05 op [ tab-previous
224 cc9bf8f2 2021-11-05 op M-[ tab-move-to
226 cc9bf8f2 2021-11-05 op M-l link-select
229 cc9bf8f2 2021-11-05 op Minibuffer-specific keys
230 cc9bf8f2 2021-11-05 op enter mini-complete-and-exit
231 cc9bf8f2 2021-11-05 op C-g mini-abort
232 cc9bf8f2 2021-11-05 op ESC mini-abort
233 cc9bf8f2 2021-11-05 op C-d mini-delete-char
234 cc9bf8f2 2021-11-05 op del mini-delete-backward-char
235 cc9bf8f2 2021-11-05 op backspace mini-delete-backward-char
236 cc9bf8f2 2021-11-05 op C-h mini-delete-backward-char
237 cc9bf8f2 2021-11-05 op C-b backward-char
238 cc9bf8f2 2021-11-05 op C-f forward-char
239 cc9bf8f2 2021-11-05 op <left> backward-char
240 cc9bf8f2 2021-11-05 op <right> forward-char
241 cc9bf8f2 2021-11-05 op C-e move-end-of-line
242 cc9bf8f2 2021-11-05 op C-a move-beginning-of-line
243 cc9bf8f2 2021-11-05 op <end> move-end-of-line
244 cc9bf8f2 2021-11-05 op <home> move-beginning-of-line
245 cc9bf8f2 2021-11-05 op C-k mini-kill-line
246 cc9bf8f2 2021-11-05 op M-p mini-previous-history-element
247 cc9bf8f2 2021-11-05 op M-n mini-next-history-element
248 cc9bf8f2 2021-11-05 op C-p previous-completion
249 cc9bf8f2 2021-11-05 op C-n next-completion
250 cc9bf8f2 2021-11-05 op <up> previous-completion
251 cc9bf8f2 2021-11-05 op <down> next-completion
252 cc9bf8f2 2021-11-05 op tab insert-current-candidate
253 cc9bf8f2 2021-11-05 op M-< mini-goto-beginning
254 cc9bf8f2 2021-11-05 op M-> mini-goto-end
256 cc9bf8f2 2021-11-05 op INTERACTIVE COMMANDS
257 cc9bf8f2 2021-11-05 op Follows the documentation for the interactive commands. These commands
258 cc9bf8f2 2021-11-05 op can be bound to a key or executed with execute-extended-command.
260 cc9bf8f2 2021-11-05 op Movement commands
261 cc9bf8f2 2021-11-05 op backward-char Move point one character backward.
262 cc9bf8f2 2021-11-05 op backward-paragraph Move point one paragraph backward.
263 cc9bf8f2 2021-11-05 op beginning-of-buffer Move point to the beginning of the buffer.
264 cc9bf8f2 2021-11-05 op end-of-buffer Move point to the end of the buffer.
265 cc9bf8f2 2021-11-05 op forward-char Move point one character forward.
266 cc9bf8f2 2021-11-05 op forward-paragraph Move point one paragraph forward.
267 cc9bf8f2 2021-11-05 op insert-current-candidate Copy the current selection text as minibuffer
269 cc9bf8f2 2021-11-05 op move-beginning-of-line Move point at the beginning of the current
270 cc9bf8f2 2021-11-05 op (visual) line.
271 cc9bf8f2 2021-11-05 op move-end-of-line Move point at the end of the current (visual)
273 cc9bf8f2 2021-11-05 op next-button Move point to the next link.
274 cc9bf8f2 2021-11-05 op next-completion Select the next completion.
275 cc9bf8f2 2021-11-05 op next-heading Move point to the next heading.
276 cc9bf8f2 2021-11-05 op next-line Move point to the next (visual) line, in the
277 cc9bf8f2 2021-11-05 op same column if possible.
278 cc9bf8f2 2021-11-05 op previous-button Move point to the previous link.
279 cc9bf8f2 2021-11-05 op previous-completion Select the previous completion.
280 cc9bf8f2 2021-11-05 op previous-heading Move point to the previous heading.
281 cc9bf8f2 2021-11-05 op previous-line Move point to the previous (visual) line.
283 cc9bf8f2 2021-11-05 op Bookmark-related commands
284 cc9bf8f2 2021-11-05 op bookmark-page Save a page in the bookmark file. It preloads
285 cc9bf8f2 2021-11-05 op the minibuffer with the current URL.
286 cc9bf8f2 2021-11-05 op list-bookmarks Load the bookmarks page.
288 cc9bf8f2 2021-11-05 op Tab-related commands
289 cc9bf8f2 2021-11-05 op tab-close Close the current tab.
290 cc9bf8f2 2021-11-05 op tab-close-other Close all tabs but the current one.
291 cc9bf8f2 2021-11-05 op tab-move Move the current tab after the next one,
292 cc9bf8f2 2021-11-05 op wrapping around if needed.
293 cc9bf8f2 2021-11-05 op tab-move-to Move the current tab before the previous one,
294 cc9bf8f2 2021-11-05 op wrapping around if needed.
295 cc9bf8f2 2021-11-05 op tab-new Open a new tab.
296 cc9bf8f2 2021-11-05 op tab-next Focus next tab, wrapping around eventually.
297 cc9bf8f2 2021-11-05 op tab-previous Focus the previous tab, wrapping around
299 cc9bf8f2 2021-11-05 op tab-select Switch to a tab using the minibuffer.
301 cc9bf8f2 2021-11-05 op Misc commands
302 cc9bf8f2 2021-11-05 op clear-minibuf Clear the echo area.
303 cc9bf8f2 2021-11-05 op dec-fill-column Decrement fill-column by two.
304 cc9bf8f2 2021-11-05 op execute-extended-command Execute an internal command.
305 cc9bf8f2 2021-11-05 op kill-telescope Quit telescope.
306 cc9bf8f2 2021-11-05 op inc-fill-column Increment fill-column by two.
307 cc9bf8f2 2021-11-05 op link-select Select and visit a link using the minibuffer.
308 cc9bf8f2 2021-11-05 op load-current-url Edit the current URL.
309 cc9bf8f2 2021-11-05 op load-url Prompt for an URL.
310 cc9bf8f2 2021-11-05 op next-page Go forward in the page history.
311 cc9bf8f2 2021-11-05 op olivetti-mode Toggle olivetti mode (i.e. horizontal centering
312 cc9bf8f2 2021-11-05 op of the lines of the window.)
313 cc9bf8f2 2021-11-05 op other-window Select the other window.
314 cc9bf8f2 2021-11-05 op previous-page Go backward in the page history.
315 cc9bf8f2 2021-11-05 op push-button Follow link at point, or toggle the visibility
316 cc9bf8f2 2021-11-05 op of the following preformatted block if called
317 cc9bf8f2 2021-11-05 op when the cursor is on the heading of the block.
318 cc9bf8f2 2021-11-05 op push-button-new-tab Follow link at point in a new tab.
319 cc9bf8f2 2021-11-05 op redraw Redraw the screen, useful if some background
320 cc9bf8f2 2021-11-05 op program messed up the display.
321 cc9bf8f2 2021-11-05 op reload-page Reload the current page.
322 cc9bf8f2 2021-11-05 op scroll-down Scroll down by one visual page.
323 cc9bf8f2 2021-11-05 op scroll-line-down Scroll down by one line.
324 cc9bf8f2 2021-11-05 op scroll-line-up Scroll up by one line.
325 cc9bf8f2 2021-11-05 op scroll-up Scroll up by one visual page.
326 cc9bf8f2 2021-11-05 op suspend-telescope Suspend the current telescope session.
327 cc9bf8f2 2021-11-05 op swiper Jump to a line using the minibuffer.
328 cc9bf8f2 2021-11-05 op toc Jump to a heading using the minibuffer.
329 cc9bf8f2 2021-11-05 op toggle-help Toggle side window with help about available
330 cc9bf8f2 2021-11-05 op keys and their associated interactive command.
331 cc9bf8f2 2021-11-05 op toggle-pre-wrap Toggle the wrapping of preformatted blocks.
333 cc9bf8f2 2021-11-05 op Minibuffer commands
334 cc9bf8f2 2021-11-05 op mini-abort Abort the current minibuffer action.
335 cc9bf8f2 2021-11-05 op mini-complete-and-exit Complete the current minibuffer action.
336 cc9bf8f2 2021-11-05 op mini-delete-backward-char
337 cc9bf8f2 2021-11-05 op Delete the character before the point.
338 cc9bf8f2 2021-11-05 op mini-delete-char Delete the character after the point.
339 cc9bf8f2 2021-11-05 op mini-goto-beginning Select the first completion, if any.
340 cc9bf8f2 2021-11-05 op mini-goto-end Select the last completion, if any.
341 cc9bf8f2 2021-11-05 op mini-kill-line Delete from point until the end of the line.
342 cc9bf8f2 2021-11-05 op mini-next-history-element
343 cc9bf8f2 2021-11-05 op Load the previous history element.
344 cc9bf8f2 2021-11-05 op mini-previous-history-element
345 cc9bf8f2 2021-11-05 op Load the next history element.
348 cc9bf8f2 2021-11-05 op The following aliases are available during execute-extended-command:
349 cc9bf8f2 2021-11-05 op tabn tab-next
350 cc9bf8f2 2021-11-05 op tabnew tab-new
351 cc9bf8f2 2021-11-05 op tabp tab-previous
352 cc9bf8f2 2021-11-05 op q and wq kill-telescope
354 cc9bf8f2 2021-11-05 op CONFIGURATION FILE
355 cc9bf8f2 2021-11-05 op During the startup, telescope reads the configuration file at
356 cc9bf8f2 2021-11-05 op ~/.telescope/config or the one given with the -c flag.
358 cc9bf8f2 2021-11-05 op telescope will also load a file called config-TERM, where TERM is the
359 cc9bf8f2 2021-11-05 op name of the terminal type (i.e. the TERM environment variable), if it
362 cc9bf8f2 2021-11-05 op The format of the configuration file is fairly flexible. The current
363 cc9bf8f2 2021-11-05 op line can be extended over multiple ones using a backslash (\).
364 cc9bf8f2 2021-11-05 op Comments can be put anywhere in the file using a hash mark (#), and
365 cc9bf8f2 2021-11-05 op extend to the end of the current line, but backslashes can't be used to
366 cc9bf8f2 2021-11-05 op extend comments over multiple lines.
368 cc9bf8f2 2021-11-05 op The following constructs are available:
370 cc9bf8f2 2021-11-05 op bind map key cmd
371 cc9bf8f2 2021-11-05 op Bind key to the function cmd in the keymap map. Valid values for
372 cc9bf8f2 2021-11-05 op map are global-map (i.e. when the user is viewing a page) and
373 cc9bf8f2 2021-11-05 op minibuffer-map (i.e. when the minibuffer has the focus.) key
374 cc9bf8f2 2021-11-05 op follows the same syntax described in DEFAULT KEY BINDINGS and all
375 cc9bf8f2 2021-11-05 op the possible functions are listed in INTERACTIVE COMMANDS.
377 cc9bf8f2 2021-11-05 op proxy proto via url
378 cc9bf8f2 2021-11-05 op Use url as proxy for all URLs with protocol proto. url must be a
379 cc9bf8f2 2021-11-05 op Gemini URI without path, query and fragment component.
381 cc9bf8f2 2021-11-05 op set opt = val
382 cc9bf8f2 2021-11-05 op Set the option opt to the value val. Valid options are:
384 cc9bf8f2 2021-11-05 op autosave (integer) If greater than zero, save the session
385 cc9bf8f2 2021-11-05 op after the specified amount of seconds after some
386 cc9bf8f2 2021-11-05 op events happens (new or closed tabs, visited a link
387 cc9bf8f2 2021-11-05 op ...) Defaults to 20.
388 cc9bf8f2 2021-11-05 op dont-wrap-pre (integer) If nonzero, don't wrap preformatted
389 cc9bf8f2 2021-11-05 op blocks. Defaults to 0.
390 cc9bf8f2 2021-11-05 op emojify-link (integer) If nonzero, when the text of a link
391 cc9bf8f2 2021-11-05 op starts with an emoji followed by a space, use that
392 cc9bf8f2 2021-11-05 op emoji as line prefix. Defaults to 1.
393 cc9bf8f2 2021-11-05 op enable-colors (integer) If nonzero, enable colours. Defaults to
394 cc9bf8f2 2021-11-05 op 0 if NO_COLORS is set, 1 otherwise.
395 cc9bf8f2 2021-11-05 op fill-column (integer) If greater than zero, lines of text will
396 cc9bf8f2 2021-11-05 op be formatted in a way that don't exceed the given
397 cc9bf8f2 2021-11-05 op number of columns. Defaults to 80.
398 cc9bf8f2 2021-11-05 op hide-pre-blocks
399 cc9bf8f2 2021-11-05 op (integer) If nonzero, hide by default the body of
400 cc9bf8f2 2021-11-05 op the preformatted blocks. Defaults to zero.
401 cc9bf8f2 2021-11-05 op push-button can be used to toggle the visibility
403 cc9bf8f2 2021-11-05 op hide-pre-closing-line
404 cc9bf8f2 2021-11-05 op (integer) If nonzero, hide the closing line of
405 cc9bf8f2 2021-11-05 op preformatted blocks. Defaults to 0.
406 cc9bf8f2 2021-11-05 op hide-pre-context
407 cc9bf8f2 2021-11-05 op (integer) If nonzero, hide the start and end line
408 cc9bf8f2 2021-11-05 op of the preformatted blocks. If both hide-pre-
409 cc9bf8f2 2021-11-05 op context and hide-pre-blocks are nonzero,
410 cc9bf8f2 2021-11-05 op preformatted blocks are irremediably hidden.
411 cc9bf8f2 2021-11-05 op Defaults to zero.
412 cc9bf8f2 2021-11-05 op new-tab-url (string) URL for the new tab page. Defaults to
414 cc9bf8f2 2021-11-05 op olivetti-mode (integer) If nonzero, enable olivetti-mode
415 cc9bf8f2 2021-11-05 op Defaults to 1.
416 cc9bf8f2 2021-11-05 op set-title (integer) If nonzero, set the terminal title to
417 cc9bf8f2 2021-11-05 op the page title. Defaults to 1.
418 cc9bf8f2 2021-11-05 op tab-bar-show (integer) If tab-bar-show is -1 hide the tab bar
419 cc9bf8f2 2021-11-05 op permanently, if 0 show it unconditionally. If
420 cc9bf8f2 2021-11-05 op it's 1, show the bar only when there is more than
421 cc9bf8f2 2021-11-05 op one tab. Defaults to 1.
423 cc9bf8f2 2021-11-05 op style name option
424 cc9bf8f2 2021-11-05 op Change the styling of the element identified by name. Multiple
425 cc9bf8f2 2021-11-05 op options may be specified within curly braces. Valid style
426 cc9bf8f2 2021-11-05 op identifiers are:
427 cc9bf8f2 2021-11-05 op line the area outside the lines in the body
429 cc9bf8f2 2021-11-05 op line.compl the completions.
430 cc9bf8f2 2021-11-05 op line.compl.current the current completion.
431 cc9bf8f2 2021-11-05 op line.help text in the *Help* buffer.
432 cc9bf8f2 2021-11-05 op line.text text lines.
433 cc9bf8f2 2021-11-05 op line.link link lines.
434 cc9bf8f2 2021-11-05 op line.title1..3 headings
435 cc9bf8f2 2021-11-05 op line.item item lines.
436 cc9bf8f2 2021-11-05 op line.quote quotes.
437 cc9bf8f2 2021-11-05 op line.pre.start the heading of a preformatted block.
438 cc9bf8f2 2021-11-05 op line.pre the content of a preformatted block.
439 cc9bf8f2 2021-11-05 op line.pre.end the closing line of a preformatted
441 cc9bf8f2 2021-11-05 op minibuffer the minibuffer.
442 cc9bf8f2 2021-11-05 op modeline the modeline.
443 cc9bf8f2 2021-11-05 op tabline the tabline.
444 cc9bf8f2 2021-11-05 op tabline.tab the non-focused tabs.
445 cc9bf8f2 2021-11-05 op tabline.current the focused tab.
447 cc9bf8f2 2021-11-05 op Valid options are:
449 cc9bf8f2 2021-11-05 op attr prefix [line [trail]]
450 cc9bf8f2 2021-11-05 op Sets the text attributes. If only one value is given,
451 cc9bf8f2 2021-11-05 op line and trail default to that; if two values are given
452 cc9bf8f2 2021-11-05 op then trail defaults to prefix. Each attribute is a
453 cc9bf8f2 2021-11-05 op comma-separated list of keywords:
454 cc9bf8f2 2021-11-05 op normal no attributes.
455 cc9bf8f2 2021-11-05 op standout best highlighting mode for the terminal.
456 cc9bf8f2 2021-11-05 op underline underlines the text.
457 cc9bf8f2 2021-11-05 op reverse reverses background/foreground colors.
458 cc9bf8f2 2021-11-05 op blink makes the text blinking.
459 cc9bf8f2 2021-11-05 op dim half bright.
460 cc9bf8f2 2021-11-05 op bold extra bright or bold.
462 cc9bf8f2 2021-11-05 op Only the style identifiers with the line. prefix accept
463 cc9bf8f2 2021-11-05 op up to three attributes. The other will only use the
464 cc9bf8f2 2021-11-05 op first one given.
466 cc9bf8f2 2021-11-05 op bg prefix [line [trail]]
467 cc9bf8f2 2021-11-05 op Sets the background color. Follows the same behaviour as
468 cc9bf8f2 2021-11-05 op attr regarding the optional parameters. The colour is
469 cc9bf8f2 2021-11-05 op one of black, red, green, yellow, blue, magenta, cyan and
470 cc9bf8f2 2021-11-05 op white; colour0 to colour255 (or color0 to color255) from
471 cc9bf8f2 2021-11-05 op the 256-colour set; default for the default colour.
473 cc9bf8f2 2021-11-05 op fg prefix [line [trail]]
474 cc9bf8f2 2021-11-05 op Sets the foreground color. It behaves just like bg.
476 cc9bf8f2 2021-11-05 op prefix prfx [cont]
477 cc9bf8f2 2021-11-05 op Sets the prefix for the current line type to prfx and
478 cc9bf8f2 2021-11-05 op cont as the prefix for the continuation lines (i.e. when
479 cc9bf8f2 2021-11-05 op a long line gets wrapped.) If cont is not given its value
480 cc9bf8f2 2021-11-05 op will be the same of prfx.
483 cc9bf8f2 2021-11-05 op When telescope is started, it inspects the following environment
486 cc9bf8f2 2021-11-05 op HOME The user's login directory.
488 cc9bf8f2 2021-11-05 op NO_COLORS To decide whether to use colors or not. The content of the
489 cc9bf8f2 2021-11-05 op variable doesn't matter.
491 cc9bf8f2 2021-11-05 op TERM The user's terminal name.
494 cc9bf8f2 2021-11-05 op ~/.telescope/bookmarks.gmi
495 cc9bf8f2 2021-11-05 op Bookmarks file.
496 cc9bf8f2 2021-11-05 op ~/.telescope/config
497 cc9bf8f2 2021-11-05 op Default configuration file.
498 cc9bf8f2 2021-11-05 op ~/.telescope/known_hosts
499 cc9bf8f2 2021-11-05 op Hash of the certificates for all the known hosts. Each line
500 cc9bf8f2 2021-11-05 op contains three fields: hostname with optional port number, hash
501 cc9bf8f2 2021-11-05 op of the certificate and a numeric flag.
502 cc9bf8f2 2021-11-05 op ~/.telescope/lock
503 cc9bf8f2 2021-11-05 op Lock file used to prevent multiple instance of telescope from
504 cc9bf8f2 2021-11-05 op running at the same time.
505 cc9bf8f2 2021-11-05 op ~/.telescope/pages/about_*.gmi
506 cc9bf8f2 2021-11-05 op Overrides for built-in about: pages.
507 cc9bf8f2 2021-11-05 op ~/.telescope/session
508 cc9bf8f2 2021-11-05 op The list of tabs from the last session. Every line identifies a
509 cc9bf8f2 2021-11-05 op tab and contains three space-separated fields: the full URL, a
510 cc9bf8f2 2021-11-05 op comma-separated list of attributes and the cached title. Is
511 cc9bf8f2 2021-11-05 op written by kill-telescope and loaded during startup.
514 cc9bf8f2 2021-11-05 op It's possible to browse the small web (i.e. simple websites) by using
515 cc9bf8f2 2021-11-05 op programs like the duckling-proxy by defining a proxy in
516 cc9bf8f2 2021-11-05 op ~/.telescope/config:
518 cc9bf8f2 2021-11-05 op proxy http via "gemini://127.0.0.1:1965"
519 cc9bf8f2 2021-11-05 op proxy https via "gemini://127.0.0.1:1965"
521 cc9bf8f2 2021-11-05 op To load telescope without any configuration
523 cc9bf8f2 2021-11-05 op telescope -c /dev/null
526 cc9bf8f2 2021-11-05 op The telescope program was written by Omar Polo <op@omarpolo.com>.
529 cc9bf8f2 2021-11-05 op There's no UI for out-of-band certificates validation.
531 cc9bf8f2 2021-11-05 op OpenBSD 7.0 August 27, 2021 OpenBSD 7.0
