| TELESCOPE(1) | General Commands Manual | TELESCOPE(1) |
telescope —
multi-protocol browser
telescope |
[-ChnSv]
[-c config]
[URL] |
telescope is an interactive browser that
supports the Finger, Gemini and Gopher protocols.
telescope features tabs, a minibuffer, interactive
completions, bookmarks and out-of-band TOFU verification.
The arguments are as follows:
-C,
--colours--colors.-c
config-h,
--help-n-S,
--safetelescope from writing files to the disk and to
acquire the lock, allowing to run multiple instances at the same time.
telescope still loads the session file and the
custom about pages.-v,
--versiontelescope interface is divided into four
areas: the tabline, the body, the modeline and the echoarea/minibuffer.
The tabline is always at the top of the screen and displays the tabs separated by a vertical line. When there are more tabs than the size of the window allow to display, the characters ‘<’ or ‘>’ are shown at the start/end of the tabline to indicate that there are more tabs in that direction.
The body occupies the majority of the visible area. It contains the current page and optionally a side window.
The modeline is the second to last row of the screen. It shows some information about the page: a spinner when the page is loading, the trust level, the document type, the scroll offset and the URL.
The echoarea is usually the last line of the screen. Messages are
often showed there, and link addresses too. The echoarea is also used to
obtain input from the user. When commands like
swiper or link-select are
invoked, the minibuffer area grows to show possible completions.
telescope aims to use the “Trust,
but Verify (where appropriate)” approach for TOFU (“Trust On
First Use”). The idea is to define three level of verification for a
certificate:
The trust level of the page is indicated in the modeline with the indicated character.
Most of the time the “trusted” level is enough, but where is appropriate users should be able to verify out-of-band the certificate.
At the moment, there is no built-in support for an out-of-band verification though.
The following protocols are supported:
telescope internal page. See
about:about for a list of all these pages.telescope, such as .gmi,
.gemini, .txt, .md, .markdown, .diff or .patch, can be viewed inside the
application. Types of local files are detected solely based on the file
extension. On some systems, such as OpenBSD, only
files inside special directories (like /tmp
or ~/Downloads) are
available.User-entered URLs, given as argument on the command line or
entered with load-url, are intepreted with a simple
heuristic:
During the startup, telescope reads the
configuration file at ~/.config/telescope/config or
~/.telescope/config.
It's possible to load a custom configuration file using the
-c flag.
telescope will also load a file called
config-TERM, where “TERM” is the name
of the terminal type (i.e. the TERM environment variable), if it exists.
The format of the configuration file is fairly flexible. The current line can be extended over multiple ones using a backslash (‘\’). Comments can be put anywhere in the file using a hash mark (‘#’), and extend to the end of the current line, but backslashes can't be used to extend comments over multiple lines.
The following constructs are available:
bind
map key
cmdproxy
proto via
urlset
opt =
valautosavedont-wrap-predownload-pathemojify-linkenable-colorsNO_COLORS is set, 1 otherwise.fill-columnfringe-ignore-offsetolivetti-mode. Defaults to 1.hide-pre-blockspush-button can be
used to toggle the visibility per-block.hide-pre-closing-linehide-pre-contextnew-tab-urlmax-killed-tabsolivetti-modeolivetti-mode
Defaults to 1.tab-bar-showupdate-titlestyle
name optionValid options are:
attr
prefix [line
[trail]]Only the style identifiers with the “line.” prefix accept up to three attributes. The other will only use the first one given.
bg
prefix [line
[trail]]attr regarding the optional parameters. The
colour is one of black, red, green, yellow, blue, magenta, cyan and
white; colour0 to colour255 (or color0 to color255) from the
256-colour set; default for the default colour.fg
prefix [line
[trail]]bg.prefix
prfx [cont]The default key bindings are very similar to GNU Emacs, but care has been taken to include also bindings familiar for vi(1) and “CUA” users. In the following examples, C-x means Control-x, M-x means Meta-x, where the Meta key may be either a special key on the keyboard or the ALT key; otherwise ESC followed by the key X works as well, and C-M-x means to press the key X together with both Control and Meta.
Keys are usually a single character, like ‘p’ or ‘n’, but some special keys are accepted as well.
Follows the documentation for the interactive commands. These
commands can be bound to a key or executed with
execute-extended-command.
backward-charbackward-paragraphbeginning-of-bufferend-of-bufferforward-charforward-paragraphinsert-current-candidatemove-beginning-of-linemove-end-of-linenext-completionnext-headingnext-lineprevious-completionprevious-headingprevious-linebookmark-pagelist-bookmarkstab-closetab-close-othertab-movetab-move-totab-newtab-nexttab-previoustab-selecttab-undo-closecache-infoclear-minibufdec-fill-columnexecute-extended-commandkill-telescopetelescope.inc-fill-columnlink-selectload-current-urlload-urlnext-pageolivetti-modeother-windowprevious-pageredrawreload-pagescroll-downscroll-line-downscroll-line-upscroll-upsuspend-telescopetelescope session.swipertoctoggle-helptoggle-pre-wrapwrite-buffermini-abortmini-complete-and-exitmini-delete-backward-charmini-delete-charmini-goto-beginningmini-goto-endmini-kill-linemini-kill-whole-linemini-next-history-elementmini-previous-history-elementThe following aliases are available during
execute-extended-command:
When telescope is started, it inspects the
following environment variables:
HOMENO_COLORSTERMXDG_CACHE_HOME,
XDG_CONFIG_HOME,
XDG_DATA_HOMEBy default telescope follows the XDG Base
Directory Specification. However, if ~/.telescope
exists, XDG is ignored and all the files are stored inside it. The usage of
XDG_CACHE_HOME,
XDG_CONFIG_HOME and
XDG_DATA_HOME can further alter the location of
these files.
telescope from running at the same time.It's possible to browse “the small web” (i.e. simple websites) by using programs like the duckling-proxy by defining a proxy in ~/.config/telescope/config:
proxy http via "gemini://127.0.0.1:1965" proxy https via "gemini://127.0.0.1:1965"
To load telescope without any
configuration
telescope -c /dev/null
XDG Base Directory Specification, https://specifications.freedesktop.org/basedir-spec/latest/.
The “Trust, but verify (where appropriate)” TOFU scheme was firstly suggested by thfr: gemini://thfr.info/gemini/modified-trust-verify.gmi.
The telescope program was written by
Omar Polo
<op@omarpolo.com>.
telescope assumes a UTF-8 environment and
doesn't try to cope with other encodings. This can cause strange rendering
issues if you're lucky, or possibly weird thing happening depending on your
locale and terminal emulator.
The algorithm used for text-wrapping is naive and doesn't really work for languages that make heavily use of glyphs composed by multiple UNICODE codepoints.
There's no UI for out-of-band certificates validation.
| January 5, 2022 | OpenBSD 7.1 |