Blob


1 => /gallery/ Gallery
2 => /telescope.1.txt Docs
4 # Telescope
6 > Telescope is a w3m-like browser for Gemini.
8 ``` Ascii art of the word “Telescope” and “v0.5.2”
9 _______ __
10 |_ _|.-----.| |.-----.-----.----.-----.-----.-----.
11 | | | -__|| || -__|__ --| __| _ | _ | -__|
12 |___| |_____||__||_____|_____|____|_____| __|_____|
13 |__| v0.5.2
14 ```
16 Telescope is written entirely for fun, as a hobbystic project in my free time. As such, it lacks a ton of features you’ll find in more mature Gemini browsers, but it also has some unique ones.
18 The UI is strongly inspired from Emacs and W3M, so you’ll find some familiar concepts, such as the minibuffer or the tabline, and the default keybindigs also reflect this, but care has been taken to add keys familiar for vi and CUA users too.
20 => https://asciinema.org/a/426862 Asciinema record
22 ## Install
24 => https://repology.org/project/telescope/versions Some distros provide a package — thanks to the maintainers!
26 Source code and precompiled binaries for linux are available:
27 => https://github.com/omar-polo/telescope/releases/download/0.5.2/telescope-0.5.2.tar.gz telescope-0.5.2.tar.gz
28 => https://github.com/omar-polo/telescope/releases/download/0.5.2/telescope.linux.aarch64 telescope.linux.aarch64
29 => https://github.com/omar-polo/telescope/releases/download/0.5.2/telescope.linux.amd64 telescope.linux.amd64
31 => https://github.com/omar-polo/telescope/releases/download/0.5.2/telescope-0.5.2-binaries.tar.gz telescope-0.5.2-binaries.tar.gz
33 When in doubt, compile from source. It’s easy and takes less than a minute on a raspberry pi 3. The dependencies are:
34 * libncurses
35 * libevent
36 * libtls (from either LibreSSL or libretls)
37 * yacc (or GNU bison)
39 Once all the dependencies are installed, building is as easy as:
41 ```Example of how to compile from source
42 $ curl -LO https://github.com/omar-polo/telescope/releases/download/0.5.2/telescope-0.5.2.tar.gz
43 $ tar xzvf telescope-0.5.2.tar.gz
44 $ cd telescope-0.5.2
45 $ ./configure
46 $ make
47 $ sudo make install # eventually
48 ```
50 A SHA256 file containing the checksums is available. However, that only checks for accidental corruption: you can use signify (SHA256.sig and the public key telescope-0.5.pub) or GPG. The hash of the signify public key is also included in the SHA256 file and signed with my GPG too. The signify public key for the next release ‘telescope-0.6.pub’ is also included.
52 => https://github.com/omar-polo/telescope/releases/download/0.5.2/SHA256 SHA256
53 => https://github.com/omar-polo/telescope/releases/download/0.5.2/SHA256.gpg SHA256.gpg
54 => https://github.com/omar-polo/telescope/releases/download/0.5.2/SHA256.sig SHA256.sig
55 => https://github.com/omar-polo/telescope/releases/download/0.5.2/telescope-0.5.pub telescope-0.5.pub
56 => https://github.com/omar-polo/telescope/releases/download/0.5.2/telescope-0.6.pub telescope-0.6.pub
58 ```Example of how to verify the signature with signify
59 $ signify -C -p telescope-0.5.2.pub -x SHA256.sig
60 Signature Verified
61 telescope-0.5.2-binaries.tar.gz: OK
62 telescope-0.5.pub: OK
63 telescope-0.5.2.tar.gz: OK
64 telescope-0.6.pub: OK
65 telescope.linux.aarch64: OK
66 telescope.linux.amd64: OK
67 ```
69 Finally, it’s possible to fetch the sources using git:
71 => //git.omarpolo.com/telescope/ git repository
72 => https://github.com/omar-polo/telescope GitHub mirror
75 ## Changelog for the last versions
77 0.5.2 “Le nuvole” bugfix release — Released September 13, 2021
79 Bugfixes:
80 * some very long pages can cause (rarely) telescope to render a blank page
81 * allow creating files in ~/Downloads on OpenBSD
82 * reset download byte counter
84 ----
86 0.5.1 “Le nuvole” bugfix release — Released August 28, 2021
88 Telescope used to trim the initial “/” in gopher requests: this is not correct and while some servers are forgiving, other (rightfully) aren't.
90 ----
92 0.5 “Le nuvole” — Released August 27, 2021
94 ## New features
96 * support for the finger protocol
97 * support for the gopher protocol (only item types 0, 1 and 7 for the moment)
98 * highlight diff/patches
99 * typing the protocol of a URI is not needed anymore: added some heuristics to assume file:// URLs and fall back to gemini:// as default
100 * open local files and directories
101 * add an autosave timer to persist the session once in a while
102 * scroll completions with M-v/C-v (mini-scroll-up/mini-scroll-down)
103 * variable `tab-bar-show' controls the visibility of the tab bar
105 ## Improvements
107 * new heuristics to extract a title for pages without headings: use the domain name or the "tilde username"
108 * about:new updated with some gopher links too
109 * reload doesn't push the current url to the history anymore
110 * push-button-new-tab opens a new tab *right after* the current one, not as the last
111 * improved the crash detection
112 * M-[ and M-] are bind to tab-move-to/tab-move
114 ## Bug fixes
116 * fixed some crashes caused by cursor movements on empty pages
117 * correctly parse multiple attributes