1 => /gallery/		Gallery
2 => /telescope.1.txt	Docs
3 
4 # Telescope
5 
6 > Telescope is a w3m-like browser for Gemini.
7 
8 ``` Ascii art of the word “Telescope” and “v0.6”
9  _______         __
10 |_     _|.-----.|  |.-----.-----.----.-----.-----.-----.
11   |   |  |  -__||  ||  -__|__ --|  __|  _  |  _  |  -__|
12   |___|  |_____||__||_____|_____|____|_____|   __|_____|
13                                            |__| v0.6
14 ```
15 
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.
17 
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.
19 
20 => https://asciinema.org/a/426862	Asciinema record
21 
22 ## Install
23 
24 => https://repology.org/project/telescope/versions Some distros provide a package — thanks to the maintainers!
25 
26 Source code and precompiled binaries for linux are available:
27 => https://github.com/omar-polo/telescope/releases/download/0.6/telescope-0.6.tar.gz	telescope-0.6.tar.gz
28 => https://github.com/omar-polo/telescope/releases/download/0.6/telescope.linux.aarch64	telescope.linux.aarch64
29 => https://github.com/omar-polo/telescope/releases/download/0.6/telescope.linux.amd64	telescope.linux.amd64
30 
31 => https://github.com/omar-polo/telescope/releases/download/0.6/telescope-0.6-binaries.tar.gz telescope-0.6-binaries.tar.gz
32 
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)
38 
39 Once all the dependencies are installed, building is as easy as:
40 
41 ```Example of how to compile from source
42 $ curl -LO https://github.com/omar-polo/telescope/releases/download/0.6/telescope-0.6.tar.gz
43 $ tar xzvf telescope-0.6.tar.gz
44 $ cd telescope-0.6
45 $ ./configure
46 $ make
47 $ sudo make install # eventually
48 ```
49 
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.6.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.7.pub’ is also included.
51 
52 => https://github.com/omar-polo/telescope/releases/download/0.6/SHA256			SHA256
53 => https://github.com/omar-polo/telescope/releases/download/0.6/SHA256.gpg		SHA256.gpg
54 => https://github.com/omar-polo/telescope/releases/download/0.6/SHA256.sig		SHA256.sig
55 => https://github.com/omar-polo/telescope/releases/download/0.6/telescope-0.6.pub	telescope-0.6.pub
56 => https://github.com/omar-polo/telescope/releases/download/0.6/telescope-0.7.pub	telescope-0.7.pub
57 
58 ```Example of how to verify the signature with signify
59 $ signify -C -p telescope-0.6.pub -x SHA256.sig
60 Signature Verified
61 telescope-0.6-binaries.tar.gz: OK
62 telescope-0.6.pub: OK
63 telescope-0.6.tar.gz: OK
64 telescope-0.7.pub: OK
65 telescope.linux.aarch64: OK
66 telescope.linux.amd64: OK
67 ```
68 
69 Finally, it’s possible to fetch the sources using git:
70 
71 => //git.omarpolo.com/telescope/		git repository
72 => https://github.com/omar-polo/telescope	GitHub mirror
73 
74 
75 ## Changelog for the latest release
76 
77 0.6 “Piccola storia ignobile” — Released November 29, 2021
78 
79 ## New features
80 
81 * added a pane that lists all the downloads (current or not)
82 * download-path is customizable
83 * sandbox/safe mode: telescope won't write anything to the file system.
84 * XDG-style directories if ~/.telescope does not exists; idea and implementation by Andrea Feletto, thanks!  (there's a script also by him in contrib to migrate the setup)
85 
86 ## Improvements
87 
88 * prefill the save prompt with the file name
89 * use landlock on linux if available
90 * add HOSTCC and HOSTCFLAGS variables for the configure script to allow cross-compiling (‘pagebundler’ needs to be built with the host compiler no matter what.)  Prompted and tested by Nikolay Korotkiy, thanks!
91 
92 ## Bug fixes
93 
94 * fix diff syntax highlighting with more than one header involved
95 * [gemini] fix item line detection: a space is required after the `*' character
96 * handle empty replies (i.e. no header.)  Found thanks to ondollo' capsule :)
97 * fixed a crash on macOs, by Nikolay Korotkiy (sikmir on github). Thanks!
98 * mention that telescope expects an UTF-8 environment in the CAVEATS section of the manpage