Blame


1 cc9bf8f2 2021-11-05 op => /gallery/ Gallery
2 cc9bf8f2 2021-11-05 op => /telescope.1.txt Docs
3 cc9bf8f2 2021-11-05 op
4 cc9bf8f2 2021-11-05 op # Telescope
5 cc9bf8f2 2021-11-05 op
6 cc9bf8f2 2021-11-05 op > Telescope is a w3m-like browser for Gemini.
7 cc9bf8f2 2021-11-05 op
8 bf34c145 2021-11-29 op ``` Ascii art of the word “Telescope” and “v0.6.1”
9 cc9bf8f2 2021-11-05 op _______ __
10 cc9bf8f2 2021-11-05 op |_ _|.-----.| |.-----.-----.----.-----.-----.-----.
11 cc9bf8f2 2021-11-05 op | | | -__|| || -__|__ --| __| _ | _ | -__|
12 cc9bf8f2 2021-11-05 op |___| |_____||__||_____|_____|____|_____| __|_____|
13 bf34c145 2021-11-29 op |__| v0.6.1
14 cc9bf8f2 2021-11-05 op ```
15 cc9bf8f2 2021-11-05 op
16 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.
17 cc9bf8f2 2021-11-05 op
18 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.
19 cc9bf8f2 2021-11-05 op
20 cc9bf8f2 2021-11-05 op => https://asciinema.org/a/426862 Asciinema record
21 cc9bf8f2 2021-11-05 op
22 cc9bf8f2 2021-11-05 op ## Install
23 cc9bf8f2 2021-11-05 op
24 cc9bf8f2 2021-11-05 op => https://repology.org/project/telescope/versions Some distros provide a package — thanks to the maintainers!
25 cc9bf8f2 2021-11-05 op
26 d9b31051 2021-12-09 op otherwise build from sources:
27 bf34c145 2021-11-29 op => https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.1.tar.gz telescope-0.6.1.tar.gz
28 cc9bf8f2 2021-11-05 op
29 5deb73b3 2021-11-29 op The dependencies are:
30 cc9bf8f2 2021-11-05 op * libncurses
31 cc9bf8f2 2021-11-05 op * libevent
32 cc9bf8f2 2021-11-05 op * libtls (from either LibreSSL or libretls)
33 cc9bf8f2 2021-11-05 op * yacc (or GNU bison)
34 cc9bf8f2 2021-11-05 op
35 cc9bf8f2 2021-11-05 op Once all the dependencies are installed, building is as easy as:
36 cc9bf8f2 2021-11-05 op
37 cc9bf8f2 2021-11-05 op ```Example of how to compile from source
38 bf34c145 2021-11-29 op $ curl -LO https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.1.tar.gz
39 bf34c145 2021-11-29 op $ tar xzvf telescope-0.6.1.tar.gz
40 bf34c145 2021-11-29 op $ cd telescope-0.6.1
41 cc9bf8f2 2021-11-05 op $ ./configure
42 cc9bf8f2 2021-11-05 op $ make
43 cc9bf8f2 2021-11-05 op $ sudo make install # eventually
44 cc9bf8f2 2021-11-05 op ```
45 cc9bf8f2 2021-11-05 op
46 d54c55fb 2021-11-29 op 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.
47 cc9bf8f2 2021-11-05 op
48 bf34c145 2021-11-29 op => https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256 SHA256
49 bf34c145 2021-11-29 op => https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256.gpg SHA256.gpg
50 bf34c145 2021-11-29 op => https://github.com/omar-polo/telescope/releases/download/0.6.1/SHA256.sig SHA256.sig
51 bf34c145 2021-11-29 op => https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.6.pub telescope-0.6.pub
52 bf34c145 2021-11-29 op => https://github.com/omar-polo/telescope/releases/download/0.6.1/telescope-0.7.pub telescope-0.7.pub
53 cc9bf8f2 2021-11-05 op
54 cc9bf8f2 2021-11-05 op ```Example of how to verify the signature with signify
55 d54c55fb 2021-11-29 op $ signify -C -p telescope-0.6.pub -x SHA256.sig
56 cc9bf8f2 2021-11-05 op Signature Verified
57 cc9bf8f2 2021-11-05 op telescope-0.6.pub: OK
58 bf34c145 2021-11-29 op telescope-0.6.1.tar.gz: OK
59 d54c55fb 2021-11-29 op telescope-0.7.pub: OK
60 cc9bf8f2 2021-11-05 op telescope.linux.aarch64: OK
61 cc9bf8f2 2021-11-05 op telescope.linux.amd64: OK
62 cc9bf8f2 2021-11-05 op ```
63 cc9bf8f2 2021-11-05 op
64 cc9bf8f2 2021-11-05 op Finally, it’s possible to fetch the sources using git:
65 cc9bf8f2 2021-11-05 op
66 cc9bf8f2 2021-11-05 op => //git.omarpolo.com/telescope/ git repository
67 cc9bf8f2 2021-11-05 op => https://github.com/omar-polo/telescope GitHub mirror
68 cc9bf8f2 2021-11-05 op
69 cc9bf8f2 2021-11-05 op
70 bf34c145 2021-11-29 op ## Changelog
71 cc9bf8f2 2021-11-05 op
72 bf34c145 2021-11-29 op 0.6.1 “Piccola storia ignobile” bugfix release — Released November 29, 2021
73 bf34c145 2021-11-29 op
74 bf34c145 2021-11-29 op * Handle gracefully when landlock is disabled at runtime. Reported and tested by Nikolay Korotkiy, thanks!
75 bf34c145 2021-11-29 op
76 bf34c145 2021-11-29 op
77 d54c55fb 2021-11-29 op 0.6 “Piccola storia ignobile” — Released November 29, 2021
78 cc9bf8f2 2021-11-05 op
79 cc9bf8f2 2021-11-05 op ## New features
80 cc9bf8f2 2021-11-05 op
81 d54c55fb 2021-11-29 op * added a pane that lists all the downloads (current or not)
82 d54c55fb 2021-11-29 op * download-path is customizable
83 d54c55fb 2021-11-29 op * sandbox/safe mode: telescope won't write anything to the file system.
84 d54c55fb 2021-11-29 op * 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 cc9bf8f2 2021-11-05 op
86 cc9bf8f2 2021-11-05 op ## Improvements
87 cc9bf8f2 2021-11-05 op
88 d54c55fb 2021-11-29 op * prefill the save prompt with the file name
89 d54c55fb 2021-11-29 op * use landlock on linux if available
90 d54c55fb 2021-11-29 op * 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 cc9bf8f2 2021-11-05 op
92 cc9bf8f2 2021-11-05 op ## Bug fixes
93 cc9bf8f2 2021-11-05 op
94 d54c55fb 2021-11-29 op * fix diff syntax highlighting with more than one header involved
95 d54c55fb 2021-11-29 op * [gemini] fix item line detection: a space is required after the `*' character
96 d54c55fb 2021-11-29 op * handle empty replies (i.e. no header.) Found thanks to ondollo' capsule :)
97 d54c55fb 2021-11-29 op * fixed a crash on macOs, by Nikolay Korotkiy (sikmir on github). Thanks!
98 d54c55fb 2021-11-29 op * mention that telescope expects an UTF-8 environment in the CAVEATS section of the manpage