Blame


1 1c1e3e26 2022-09-08 op <div class="banner">
2 1c1e3e26 2022-09-08 op ``` Ascii art of the word “Telescope” and “vCURRV”
3 cc9bf8f2 2021-11-05 op _______ __
4 cc9bf8f2 2021-11-05 op |_ _|.-----.| |.-----.-----.----.-----.-----.-----.
5 cc9bf8f2 2021-11-05 op | | | -__|| || -__|__ --| __| _ | _ | -__|
6 cc9bf8f2 2021-11-05 op |___| |_____||__||_____|_____|____|_____| __|_____|
7 1c1e3e26 2022-09-08 op |__| vCURRV
8 cc9bf8f2 2021-11-05 op ```
9 1c1e3e26 2022-09-08 op </div>
10 cc9bf8f2 2021-11-05 op
11 1c1e3e26 2022-09-08 op > Telescope is a w3m-like browser for Gemini.
12 1c1e3e26 2022-09-08 op
13 1c1e3e26 2022-09-08 op <section class="with-image">
14 1c1e3e26 2022-09-08 op <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 1c1e3e26 2022-09-08 op <div>
16 1c1e3e26 2022-09-08 op
17 cc9bf8f2 2021-11-05 op 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 cc9bf8f2 2021-11-05 op
19 1c1e3e26 2022-09-08 op => telescope.1.MANEXT documentation
20 1c1e3e26 2022-09-08 op
21 cc9bf8f2 2021-11-05 op 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 04c9c60c 2022-09-08 op
23 9da92e01 2023-11-10 op => gemini://omg.pebcak.club/~freezr/gemlog/2022-09-02-telescope-logo.gmi The awesome logo was made by freezr!
24 1c1e3e26 2022-09-08 op </div>
25 1c1e3e26 2022-09-08 op </section>
26 cc9bf8f2 2021-11-05 op
27 1c1e3e26 2022-09-08 op <p><a href="https://asciinema.org/a/426862" target="_blank"><img src="https://asciinema.org/a/426862.svg" /></a></p>
28 cc9bf8f2 2021-11-05 op => https://asciinema.org/a/426862 Asciinema record
29 cc9bf8f2 2021-11-05 op
30 cc9bf8f2 2021-11-05 op ## Install
31 cc9bf8f2 2021-11-05 op
32 1c1e3e26 2022-09-08 op <p class='repology'><a href='REPOLOGY_URL'><img src='REPOLOGY_BANNER' alt='distro that provide a telescope package' /></a></p>
33 1c1e3e26 2022-09-08 op => REPOLOGY_URL Some distros provide a package — thanks to the maintainers!
34 cc9bf8f2 2021-11-05 op
35 e2521d9a 2024-02-23 op Source code is available for download:
36 cc9bf8f2 2021-11-05 op
37 e2521d9a 2024-02-23 op => https://ftp.omarpolo.com/telescope-CURRV.tar.gz telescope-CURRV.tar.gz
38 d9bfe90a 2022-01-13 op
39 d7905c75 2022-07-18 op => https://git.omarpolo.com/?index_page=&path=telescope.git&action=summary git repository
40 2c3c9afd 2022-05-25 op => https://codeberg.org/op/telescope/ Codeberg mirror
41 d9bfe90a 2022-01-13 op => https://github.com/omar-polo/telescope GitHub mirror
42 d9bfe90a 2022-01-13 op
43 e2521d9a 2024-02-23 op 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.
44 d9bfe90a 2022-01-13 op
45 cc9bf8f2 2021-11-05 op Once all the dependencies are installed, building is as easy as:
46 cc9bf8f2 2021-11-05 op
47 cc9bf8f2 2021-11-05 op ```Example of how to compile from source
48 e84bdc43 2024-02-23 op $ curl -O https://ftp.omarpolo.com/telescope-CURRV.tar.gz
49 e2521d9a 2024-02-23 op $ tar xzvf telescope-CURRV.tar.gz
50 e2521d9a 2024-02-23 op $ cd telescope-CURRV
51 cc9bf8f2 2021-11-05 op $ ./configure
52 cc9bf8f2 2021-11-05 op $ make
53 e84bdc43 2024-02-23 op $ sudo make install # eventually
54 cc9bf8f2 2021-11-05 op ```
55 cc9bf8f2 2021-11-05 op
56 63dff8d4 2024-02-24 op 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.
57 cc9bf8f2 2021-11-05 op
58 63dff8d4 2024-02-24 op => https://ftp.omarpolo.com/telescope-CURRV.tar.gz.sha256 telescope-CURRV.tar.gz.sha256
59 63dff8d4 2024-02-24 op => https://ftp.omarpolo.com/telescope-CURRV.tar.gz.sha256.sig telescope-CURRV.tar.gz.sha256.sig
60 63dff8d4 2024-02-24 op => https://ftp.omarpolo.com/telescope-CURRKEY.pub telescope-CURRKEY.pub
61 63dff8d4 2024-02-24 op => https://ftp.omarpolo.com/telescope-NEXTKEY.pub telescope-NEXTKEY.pub
62 cc9bf8f2 2021-11-05 op
63 cc9bf8f2 2021-11-05 op ```Example of how to verify the signature with signify
64 63dff8d4 2024-02-24 op $ signify -C -p telescope-CURRKEY.pub -x telescope-CURRV.tar.gz.sha256.sig
65 cc9bf8f2 2021-11-05 op Signature Verified
66 e2521d9a 2024-02-23 op telescope-CURRV.tar.gz: OK
67 cc9bf8f2 2021-11-05 op ```
68 cc9bf8f2 2021-11-05 op
69 63dff8d4 2024-02-24 op telescope-CURRKEY.pub is:
70 cc9bf8f2 2021-11-05 op
71 e84bdc43 2024-02-23 op ```
72 63dff8d4 2024-02-24 op CURRSIGN
73 e84bdc43 2024-02-23 op ```
74 e84bdc43 2024-02-23 op
75 e84bdc43 2024-02-23 op and is available inside the tarball in the keys/ directory, along with all the previous and public key for the next release as well.
76 e84bdc43 2024-02-23 op
77 e84bdc43 2024-02-23 op Starting from Telescope 0.9, git tags are signed with the following ssh key:
78 e84bdc43 2024-02-23 op
79 e84bdc43 2024-02-23 op ```
80 e84bdc43 2024-02-23 op ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIJ0nD5I8BNVJknT87gnpLIJWK0fXTayDktQOlS38CGj4 op@omarpolo.com
81 e84bdc43 2024-02-23 op ```
82 e84bdc43 2024-02-23 op
83 e84bdc43 2024-02-23 op
84 bf34c145 2021-11-29 op ## Changelog
85 cc9bf8f2 2021-11-05 op
86 8d3a30b1 2024-02-23 op 0.9 “Cielo Super Acceso” — Released February 23, 2024
87 56274e43 2022-05-25 op
88 1a7a3e45 2024-02-27 op Note to packagers: starting from this release, Telescope doesn't depend on libevent anymore, and optionally depends on libgrapheme.
89 1a7a3e45 2024-02-27 op
90 d9bfe90a 2022-01-13 op ### New features
91 bf34c145 2021-11-29 op
92 e4bf5d18 2024-02-22 op * Initial client certificate support.
93 e4bf5d18 2024-02-22 op * Use libgrapheme for text reflowing: improves the word-wrapping for languages that don't use latin characters.
94 e4bf5d18 2024-02-22 op * New commands for quick navigation: `up', `root' and `home' bound to "g u", "g r" and "g h" respectively.
95 e4bf5d18 2024-02-22 op * Added a `search' command to quickly consult a search engine, as well as the `default-search-engine' option.
96 e4bf5d18 2024-02-22 op * Added `load-url-use-heuristic' configuration option.
97 e4bf5d18 2024-02-22 op * Added `default-protocol' configuration option.
98 e4bf5d18 2024-02-22 op * Added telescope-identity(1) to create, delete and manage client certificates.
99 e4bf5d18 2024-02-22 op
100 d9bfe90a 2022-01-13 op ### Improvements
101 cc9bf8f2 2021-11-05 op
102 e4bf5d18 2024-02-22 op * Implemented a new URI parser: this will allow in the future to support IRIs too.
103 e2521d9a 2024-02-23 op * 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 e4bf5d18 2024-02-22 op * Removed the dependency on libevent: Telescope now uses a custom built-in event loop.
105 e4bf5d18 2024-02-22 op * Rework the history management: the code is cleaner and requires less memory.
106 e4bf5d18 2024-02-22 op * Reduced the amount of memory needed for rendering the pages by roughly 50%.
107 e4bf5d18 2024-02-22 op * Landlock sandboxing is enabled again on Linux.
108 e4bf5d18 2024-02-22 op * Update data/emoji.txt to UNICODE 15.0.
109 e4bf5d18 2024-02-22 op
110 99a9bb37 2022-05-25 op ### Bug Fixes
111 e4bf5d18 2024-02-22 op
112 e4bf5d18 2024-02-22 op * Fixed wrapping of link lines.
113 e4bf5d18 2024-02-22 op * Fixed `bookmark-page' bogus error message.
114 e4bf5d18 2024-02-22 op * Fixed caching of finger pages too.
115 e4bf5d18 2024-02-22 op * Save to the persistent history finger:// and gopher:// URLs as well.
116 e4bf5d18 2024-02-22 op * Fixed handling of gopher selectors with spaces and other "funny" characters.
117 e4bf5d18 2024-02-22 op * Improved handling of connect(2) failures, as well as error reporting.
118 e4bf5d18 2024-02-22 op * Changed the default colours for patch/diff to magenta and cyan.
119 e4bf5d18 2024-02-22 op * Updated the link to the official gemini project capsule in about:new.
120 e4bf5d18 2024-02-22 op * Corrected and extended about:license.
121 e4bf5d18 2024-02-22 op
122 e4bf5d18 2024-02-22 op ### Breaking changes
123 e4bf5d18 2024-02-22 op
124 e4bf5d18 2024-02-22 op * Removed the -C/--colours flag: telescope is not a colour picker.