Blob


1 <div class="banner">
2 ``` Ascii art of the word “Telescope” and “vCURRV”
3 _______ __
4 |_ _|.-----.| |.-----.-----.----.-----.-----.-----.
5 | | | -__|| || -__|__ --| __| _ | _ | -__|
6 |___| |_____||__||_____|_____|____|_____| __|_____|
7 |__| vCURRV
8 ```
9 </div>
11 > Telescope is a w3m-like browser for Gemini.
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>
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.
19 => telescope.1.MANEXT documentation
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.
23 => gemini://omg.pebcak.club/~freezr/gemlog/2022-09-02-telescope-logo.gmi The awesome logo was made by freezr!
24 </div>
25 </section>
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
30 ## Install
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!
35 Source code is available for download:
37 => https://ftp.omarpolo.com/telescope-CURRV.tar.gz telescope-CURRV.tar.gz
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
43 Telescope depends are ncursesw, libtls or libretls, and pkg-config. libgrapheme is also needed, although there's a bundled copy. When building from a git checkout, yacc (or bison) is also needed.
45 Once all the dependencies are installed, building is as easy as:
47 ```Example of how to compile from source
48 $ curl -O https://ftp.omarpolo.com/telescope-CURRV.tar.gz
49 $ tar xzvf telescope-CURRV.tar.gz
50 $ cd telescope-CURRV
51 $ ./configure
52 $ make
53 $ sudo make install # eventually
54 ```
56 A telescope-CURRV.tar.gz.sha256 file containing the checksums is available. However, that only checks for accidental corruption: you can use signify (telescope-CURRV.tar.gz.sha256.sig and the public key telescope-CURRKEY.pub). The hash of the current and next signify public key is also included in the telescope-CURRV.tar.gz.
58 => https://ftp.omarpolo.com/telescope-CURRV.tar.gz.sha256 telescope-CURRV.tar.gz.sha256
59 => https://ftp.omarpolo.com/telescope-CURRV.tar.gz.sha256.sig telescope-CURRV.tar.gz.sha256.sig
60 => https://ftp.omarpolo.com/telescope-CURRKEY.pub telescope-CURRKEY.pub
61 => https://ftp.omarpolo.com/telescope-NEXTKEY.pub telescope-NEXTKEY.pub
63 ```Example of how to verify the signature with signify
64 $ signify -C -p telescope-CURRKEY.pub -x telescope-CURRV.tar.gz.sha256.sig
65 Signature Verified
66 telescope-CURRV.tar.gz: OK
67 ```
69 telescope-CURRKEY.pub is:
71 ```
72 CURRSIGN
73 ```
75 and is available inside the tarball in the keys/ directory, along with all the previous and public key for the next release as well.
77 Starting from Telescope 0.9, git tags are signed with the following ssh key:
79 ```
80 ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIJ0nD5I8BNVJknT87gnpLIJWK0fXTayDktQOlS38CGj4 op@omarpolo.com
81 ```
84 ## Changelog
86 0.9 “Cielo Super Acceso” — Released February 23, 2024
88 Note to packagers: starting from this release, Telescope doesn't depend on libevent anymore, and optionally depends on libgrapheme.
90 ### New features
92 * Initial client certificate support.
93 * Use libgrapheme for text reflowing: improves the word-wrapping for languages that don't use latin characters.
94 * New commands for quick navigation: `up', `root' and `home' bound to "g u", "g r" and "g h" respectively.
95 * Added a `search' command to quickly consult a search engine, as well as the `default-search-engine' option.
96 * Added `load-url-use-heuristic' configuration option.
97 * Added `default-protocol' configuration option.
98 * Added telescope-identity(1) to create, delete and manage client certificates.
100 ### Improvements
102 * Implemented a new URI parser: this will allow in the future to support IRIs too.
103 * Allow configuration options to be booleans ("true" and "false") and change a few options where it made sense. The old settings with 0 and 1 will continue to work for some time.
104 * Removed the dependency on libevent: Telescope now uses a custom built-in event loop.
105 * Rework the history management: the code is cleaner and requires less memory.
106 * Reduced the amount of memory needed for rendering the pages by roughly 50%.
107 * Landlock sandboxing is enabled again on Linux.
108 * Update data/emoji.txt to UNICODE 15.0.
110 ### Bug Fixes
112 * Fixed wrapping of link lines.
113 * Fixed `bookmark-page' bogus error message.
114 * Fixed caching of finger pages too.
115 * Save to the persistent history finger:// and gopher:// URLs as well.
116 * Fixed handling of gopher selectors with spaces and other "funny" characters.
117 * Improved handling of connect(2) failures, as well as error reporting.
118 * Changed the default colours for patch/diff to magenta and cyan.
119 * Updated the link to the official gemini project capsule in about:new.
120 * Corrected and extended about:license.
122 ### Breaking changes
124 * Removed the -C/--colours flag: telescope is not a colour picker.