1 <div class="banner">
2 ``` Ascii art of the word “Telescope” and “vCURRV”
3  _______         __
4 |_     _|.-----.|  |.-----.-----.----.-----.-----.-----.
5   |   |  |  -__||  ||  -__|__ --|  __|  _  |  _  |  -__|
6   |___|  |_____||__||_____|_____|____|_____|   __|_____|
7                                            |__| vCURRV
8 ```
9 </div>
10 
11 > Telescope is a w3m-like browser for Gemini.
12 
13 <section class="with-image">
14 <img src="logo.small.png" alt="the teleoscope logo: a telescope on a tripode with a city and the earth seen from space in the background, with some stars behind" title='Telescope logo -- by freezr'>
15 <div>
16 
17 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 
19 => telescope.1.MANEXT	documentation
20 
21 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.
22 
23 => gemini://warp.geminispace.club/~freezr/gemlog/2022-09-02-telescope-logo.gmi The awesome logo was made by freezr!
24 </div>
25 </section>
26 
27 <p><a href="https://asciinema.org/a/426862" target="_blank"><img src="https://asciinema.org/a/426862.svg" /></a></p>
28 => https://asciinema.org/a/426862	Asciinema record
29 
30 ## Install
31 
32 <p class='repology'><a href='REPOLOGY_URL'><img src='REPOLOGY_BANNER' alt='distro that provide a telescope package' /></a></p>
33 => REPOLOGY_URL Some distros provide a package — thanks to the maintainers!
34 
35 Source code and precompiled binaries for linux are available:
36 
37 => https://github.com/omar-polo/telescope/releases/download/0.8.1/telescope-0.8.1.tar.gz telescope-0.8.1.tar.gz
38 
39 => https://git.omarpolo.com/?index_page=&path=telescope.git&action=summary git repository
40 => https://codeberg.org/op/telescope/		Codeberg mirror
41 => https://github.com/omar-polo/telescope	GitHub mirror
42 
43 => https://github.com/omar-polo/telescope/releases/download/0.8/telescope.amd64	telescope.amd64
44 
45 The dependencies are:
46 * libncurses
47 * libevent
48 * libtls (from either LibreSSL or libretls)
49 * yacc (or GNU bison)
50 
51 Once all the dependencies are installed, building is as easy as:
52 
53 ```Example of how to compile from source
54 $ curl -LO https://github.com/omar-polo/telescope/releases/download/0.8.1/telescope-0.8.1.tar.gz
55 $ tar xzvf telescope-0.8.1.tar.gz
56 $ cd telescope-0.8.1
57 $ ./configure
58 $ make
59 $ sudo make install # eventually
60 ```
61 
62 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.8.pub).  The hash of the current and next signify public key is also included in the SHA256.
63 
64 => https://github.com/omar-polo/telescope/releases/download/0.8.1/SHA256		SHA256
65 => https://github.com/omar-polo/telescope/releases/download/0.8.1/SHA256.sig		SHA256.sig
66 => https://github.com/omar-polo/telescope/releases/download/0.8.1/telescope-0.8.pub	telescope-0.8.pub
67 => https://github.com/omar-polo/telescope/releases/download/0.8.1/telescope-0.9.pub	telescope-0.9.pub
68 
69 ```Example of how to verify the signature with signify
70 $ signify -C -p telescope-0.8.pub -x SHA256.sig
71 Signature Verified
72 telescope-0.8-binaries.tar.gz: OK
73 telescope-0.8.1.tar.gz: OK
74 telescope-0.8.pub: OK
75 telescope-0.9.pub: OK
76 telescope.amd64: OK
77 ```
78 
79 
80 ## Changelog
81 
82 0.8.1  “Le Scarpe Volanti” buildfix release — Released May 25, 2022
83 
84 * Fix the build on macos.  Reported by sikmir, thanks!
85 
86 
87 0.8 “Le Scarpe Volanti” — Released May 25, 2022
88 
89 ### New features
90 * save and restore scroll position
91 * new command reply-last-input; idea from a conversation with thfr@, thanks!
92 * allow push urls to an already opened telescope session
93 * autocompletions for load-url and load-current-url
94 * new command write-buffer (with alias w)
95 * new command mini-kill-whole-line for the minibuffer
96 * split the minibuffer input into words and try to match out of order
97 
98 ### Improvements
99 * move aliases at the top of the completions
100 * add alias `open' for load-url; suggested by Florian, thanks!
101 * update emoji-data.txt to 14.0.0
102 * persist the list of visited URLs to the disk
103 * fix builds out-of-tree
104 * correctly mark variables in the manpage so it's possible to jump to them
105 * rework completions selection: the selected entry is *always* the one used.  if nothing is selected, the minibuffer content is used instead.
106 * merge the ui and fs processes
107 * rate-limit the update of the download pane
108 
109 ### Bug Fixes
110 * fix parsing of invalid link lines
111 * initialize each tab' loadingev timer event
112 * fix the build on recent version of musl