Blob


1 <!doctype html>
2 <html lang="en">
3 <head>
4 <title>Telescope</title>
5 <meta charset="utf8">
6 <meta name="viewport" content="width=device-width, initial-scale=1">
7 <style>
8 body {
9 font-family: monospace;
10 font-size: 14px;
11 max-width: 780px;
12 margin: 0 auto;
13 padding: 20px;
14 padding-bottom: 80px;
15 }
17 h1::before {
18 content: "# ";
19 }
21 h2 {
22 margin-top: 40px;
23 }
25 h2::before {
26 content: "## ";
27 }
29 h3::before {
30 content: "### ";
31 }
33 blockquote {
34 margin: 0;
35 padding: 0;
36 }
38 blockquote::before {
39 content: "> ";
40 }
42 blockquote p {
43 font-style: italic;
44 display: inline;
45 }
47 p.link::before {
48 content: "→ ";
49 }
51 hr {
52 border: 0;
53 height: 1px;
54 background-color: #222;
55 width: 100%;
56 display: block;
57 margin: 2em auto;
58 }
60 pre {
61 overflow: auto;
62 }
64 pre.banner {
65 display: flex;
66 flex-direction: row;
67 justify-content: center;
68 }
70 code, kbd {
71 color: #9d109d;
72 }
74 img {
75 display: block;
76 margin: 0 auto;
77 max-width: 100%;
78 }
80 @media (prefers-color-scheme: dark) {
81 body {
82 background-color: #222;
83 color: white;
84 }
86 img {
87 filter: brightness(0.65);
88 transition: filter 0.2s ease-in-out;
89 }
91 img:hover {
92 filter: brightness(1.0);
93 }
95 a {
96 color: aqua;
97 }
99 hr {
100 background-color: #ddd;
103 code, kbd {
104 color: #ff4cff;
108 @media (max-width: 400px) {
109 pre.banner { font-size: 9px; }
112 @media (max-width: 500px) {
113 pre.banner { font-size: 10px; }
115 </style>
116 </head>
117 <body>
118 <header>
119 <nav>
120 Home | <a href="/gallery/">Gallery</a> | <a href="telescope.1.html">Docs</a>
121 </nav>
122 </header>
123 <pre class="banner"> _______ __
124 |_ _|.-----.| |.-----.-----.----.-----.-----.-----.
125 | | | -__|| || -__|__ --| __| _ | _ | -__|
126 |___| |_____||__||_____|_____|____|_____| __|_____|
127 |__| v0.7.1</pre>
128 <blockquote>
129 <p>Telescope is a w3m-like browser for Gemini</p>
130 </blockquote>
131 <p>
132 Telescope is written entirely for fun, as a hobbystic project in
133 my free time. As such, it lacks a ton of features you’ll find
134 in more mature Gemini browsers, but it also has some unique
135 ones.
136 </p>
137 <p>
138 The UI is strongly inspired from Emacs and W3M, so you’ll find
139 some familiar concepts, such as the minibuffer or the tabline,
140 and the default keybindigs also reflect this, but keys familiar
141 for vi and CUA users are also present by default.
142 </p>
143 <p>
144 <a href="https://asciinema.org/a/426862" target="_blank">
145 <img src="https://asciinema.org/a/426862.svg" />
146 </a>
147 </p>
148 <h2>Install</h2>
149 <p>Some distros provide a package — thanks to the maintainers!</p>
150 <a href="https://repology.org/project/telescope/versions">
151 <img src="https://repology.org/badge/vertical-allrepos/telescope.svg" alt="Packaging status">
152 </a>
153 <p>Source code and precompiled binaries for linux are available:</p>
154 <ul>
155 <li>
156 <a href="https://github.com/omar-polo/telescope/releases/download/0.7.1/telescope-0.7.1.tar.gz">
157 telescope-0.7.1.tar.gz
158 </a>
159 </li>
160 <li>
161 <a href="https://git.omarpolo.com/telescope/">git repository</a>
162 </li>
163 <li>
164 <a href="https://github.com/omar-polo/telescope">GitHub mirror</a>
165 </li>
166 <li>
167 <a href="https://github.com/omar-polo/telescope/releases/download/0.7.1/telescope.aarch64">
168 telescope.aarch64
169 </a>
170 </li>
171 <li>
172 <a href="https://github.com/omar-polo/telescope/releases/download/0.7.1/telescope.amd64">
173 telescope.amd64
174 </a>
175 </li>
176 </ul>
177 <p>The dependencies are:</p>
178 <ul>
179 <li>libncurses</li>
180 <li>libevent</li>
181 <li>libtls (from either LibreSSL or libretls)</li>
182 <li>yacc (or GNU bison)</li>
183 </ul>
184 <p>Once all the dependencies are installed, building is as easy as:</p>
185 <pre>$ curl -LO https://github.com/omar-polo/telescope/releases/download/0.7.1/telescope-0.7.1.tar.gz
186 $ tar xzvf telescope-0.7.1.tar.gz
187 $ cd telescope-0.7.1
188 $ ./configure
189 $ make
190 $ sudo make install # eventually
191 </pre>
192 <p>
193 A SHA256 file containing the checksums is available. However,
194 that only checks for accidental corruption: you can use signify
195 (<code>SHA256.sig</code> and the public key
196 <code>telescope-0.7.pub</code>) or GPG. The hash of the signify
197 public key is also included in the SHA256 file and signed with
198 my GPG too. The signify public key for the next release
199 <code>telescope-0.8.pub</code> is also included.
200 </p>
201 <ul>
202 <li>
203 <a href="https://github.com/omar-polo/telescope/releases/download/0.7.1/SHA256">
204 SHA256
205 </a>
206 </li>
207 <li>
208 <a href="https://github.com/omar-polo/telescope/releases/download/0.7.1/SHA256.gpg">
209 SHA256.gpg
210 </a>
211 </li>
212 <li>
213 <a href="https://github.com/omar-polo/telescope/releases/download/0.7.1/SHA256.sig">
214 SHA256.sig
215 </a>
216 </li>
217 <li>
218 <a href="https://github.com/omar-polo/telescope/releases/download/0.7.1/telescope-0.7.pub">
219 telescope-0.7.pub
220 </a>
221 </li>
222 <li>
223 <a href="https://github.com/omar-polo/telescope/releases/download/0.7.1/telescope-0.8.pub">
224 telescope-0.8.pub
225 </a>
226 </li>
227 </ul>
228 <p>How to verify the signature with signify:</p>
229 <pre>$ signify -C -p telescope-0.7.pub -x SHA256.sig
230 Signature Verified
231 telescope-0.7.1-binaries.tar.gz: OK
232 telescope-0.7.1.tar.gz: OK
233 telescope-0.7.pub: OK
234 telescope-0.8.pub: OK
235 telescope.aarch64: OK
236 telescope.amd64: OK
237 </pre>
238 <h2>Changelog</h2>
239 <p>0.7.1 “Via Paolo Fabbri 43” bugfix release — Released January 15, 2022</p>
240 <h3>Bug fixes</h3>
241 <ul>
242 <li>
243 fix an use-after-free when loading an <code>about:*</code> URL from
244 <code>about:about</code>. Reported by Brian Callahan, thanks!
245 </li>
246 </ul>
247 <hr />
248 <p>0.7 “Via Paolo Fabbri 43” — Released January 13, 2022</p>
249 <h3>New features</h3>
250 <ul>
251 <li>
252 caching: telescope will keep a in-memory copy of the visited
253 page for some time to speed up history navigation. See also
254 the new command <code>cache-info</code>.
255 </li>
256 <li>
257 persistent tab history: telescope will remember the full
258 history for each tab across sessions.
259 </li>
260 <li>
261 re-open closed tabs (even across sessions!) The <kbd>u</kbd>
262 key is now bound to <code>tab-undo-close</code> by default.
263 </li>
264 <li>
265 allow to customise the space after the end of the buffer. By
266 default telescope now renders a vi-like tilde fringe "~", but
267 it's fully customisable using the new <code>line.fringe</code>
268 style identifier. See also the new setting
269 <code>fringe-ignore-offset</code>.
270 </li>
271 </ul>
272 <h3>Improvements</h3>
273 <ul>
274 <li>ask before quitting telescope.</li>
275 <li>
276 execute-extended-command: execute the selected command on RET.
277 </li>
278 <li>bump default fill-column to 120.</li>
279 <li>
280 bind <kbd>del</kbd> (backspace) to previous-page. Suggested by
281 Florian, thanks!
282 </li>
283 <li>
284 add <code>--colours</code> as <code>--color</code> alias.
285 Suggested by Florian.
286 </li>
287 </ul>
288 <h3>Bug fixes</h3>
289 <ul>
290 <li>
291 fixed crash on <code>--colors</code>. Reported by Florian,
292 thanks!
293 </li>
294 <li>
295 don't push the current url to the history <em>twice</em> at
296 startup.
297 </li>
298 </ul>
299 <h3>Breaking Changes</h3>
300 <ul>
301 <li>
302 variable <code>set-title</code> renamed to
303 <code>update-title</code>.
304 The old name will still be supported for a while to ease
305 backwards compatibility.
306 </li>
307 </ul>
308 </body>
309 </html>