Commit Briefs

Omar Polo

-current again (main)

Omar Polo

bump version to 0.10.1 (tags/0.10.1)

Omar Polo

sync changelog

Omar Polo

add note about minor release




.cirrus.ymlcommits | blame
.gitignorecommits | blame
.woodpecker.yamlcommits | blame
ChangeLogcommits | blame
LICENSEcommits | blame
Makefile.amcommits | blame
README.mdcommits | blame*commits | blame
bufio.ccommits | blame
bufio.hcommits | blame
certs.ccommits | blame
certs.hcommits | blame
cmd.ccommits | blame
cmd.hcommits | blame
compat.hcommits | blame
compl.ccommits | blame
compl.hcommits | blame
configure.accommits | blame
control.ccommits | blame
control.hcommits | blame
defaults.ccommits | blame
defaults.hcommits | blame
downloads.ccommits | blame
ev.ccommits | blame
ev.hcommits | blame
exec.ccommits | blame
exec.hcommits | blame
fs.ccommits | blame
fs.hcommits | blame
gencmd.awkcommits | blame*commits | blame
help.ccommits | blame
hist.ccommits | blame
hist.hcommits | blame
identity.ccommits | blame
imsgev.ccommits | blame
imsgev.hcommits | blame
iri.ccommits | blame
iri.hcommits | blame
keymap.ccommits | blame
keymap.hcommits | blame
mailcap.ccommits | blame
mailcap.hcommits | blame
mcache.ccommits | blame
mcache.hcommits | blame
mime.ccommits | blame
minibuffer.ccommits | blame
minibuffer.hcommits | blame
net.ccommits | blame
pagebundler.ccommits | blame
pages.hcommits | blame
parse.ycommits | blame
parser.ccommits | blame
parser.hcommits | blame
parser_gemtext.ccommits | blame
parser_gophermap.ccommits | blame
parser_textpatch.ccommits | blame
parser_textplain.ccommits | blame
sandbox.ccommits | blame
session.ccommits | blame
session.hcommits | blame
telescope-identity.1commits | blame
telescope.1commits | blame
telescope.ccommits | blame
telescope.hcommits | blame
tofu.ccommits | blame
tofu.hcommits | blame
ui.ccommits | blame
ui.hcommits | blame
utf8.ccommits | blame
utf8.hcommits | blame
utils.ccommits | blame
utils.hcommits | blame
wrap.ccommits | blame
xwrapper.ccommits | blame
xwrapper.hcommits | blame

# Telescope

Telescope is a Emacs/w3m-inspired browser for the "small internet"
that supports Gemini, Gopher and Finger.

In features some expected stuff (tabs, bookmarks, history, client
certificates, ...) with an UI that's very much Emacs and w3m inspired,
and a privsep design.

There are still various things missing or, if you prefer, various
things that you can help develop :)

 - other "smol internet" protocols
 - subscriptions
 - TOFU out-of-band verification and/or DANE
 - multiple UIs: at the moment it uses only ncurses, but telescope
   shouldn't be restricted to TTYs only!


## Why yet another browser?

One of the great virtues of Gemini is its simplicity.  It means that
writing browsers or server is easy and thus a plethora of those
exists.  I myself routinely switch between a couple of them, depending
on my mood.

More browsers means more choice for the users, and more stability for
the protocol too.

However, Telescope was ultimately written for fun, on a whim, just to
play with ncurses, libtls, async I/O and the macros from `sys/queue.h`,
but I'd like to finish it into a complete Gemini browser.

## Goals

 - Fun: hacking on Telescope should be fun.
 - Clean: write readable and clean code mostly following the OpenBSD
   style(9) guideline.  Don't become a kitchen sink.
 - Secure: write secure code with privilege separation to mitigate the
   security risks of possible bugs.
 - Fast: it features a modern, fast, event-based asynchronous I/O
 - Cooperation: re-use existing conventions to allow inter-operations
   and easy migrations from/to other clients.


Telescope aims to use the "Trust, but Verify (where appropriate)"
approach outlined here:

The idea is to define three level of verification for a certificate:

 - **untrusted**: the server fingerprint does NOT match the stored
 - **trusted**: the server fingerprint matches the stored one
 - **verified**: the fingerprint matches and has been verified
   out-of-band by the client.

Most of the time, the `trusted` level is enough, but where is
appropriate users should be able to verify out-of-band the

At the moment there is no UI for out-of-band verification though.

## Building

Telescope depends on ncursesw, libtls or libretls, yacc/bison and
pkg-config.  [libgrapheme][libgrapheme] is an optional dependency:
there's a bundled copy but it's reccomended to install it with a package
manager if available.

To build execute:

	$ ./		# only from git checkouts
	$ ./configure
	$ make
	$ sudo make install	# eventually

The configure script has optional support for building with libraries
provided by your distribution instead of using the bundled versions:

 - `--with-libbsd`: link with [libbsd][libbsd]
 - `--with-libimsg`: link with the [imsg-compat][imsg-compat] library

The default-editor can be changed at build-time with the following option:

 - `--with-default-editor`: defaults to `ed(1)`

This is useful for distributions such as Debian, which prefers
`sensible-editor(1)` as a wrapper.

This feature is mostly useful with the `mini-edit-external` command in


## Contributing

Any form of contribution is appreciated, not only patches or bug
reports: feel free to open an issue or send an email to

If you have a sample configuration, custom theme, a script or anything
that could be helpful to others, consider adding it to the `contrib`

Consider also joining the official
[irc channel](ircs://,
`#telescope` on!

## User files

Telescope stores user files according to the [XDG Base Directory
Specification][xdg] by default.  The usage and contents of these files
are described in [the man page](telescope.1), under "FILES".

At the moment, only one instance of Telescope can be running at time per

## License

Telescope is distributed under a BSD-style licence.  The main code is
either under the ISC or is Public Domain, but some files under `compat/`
are 3-Clause BSD or MIT.  See the first few lines of every file or
`about:license` inside telescope for the copyright information.

`data/emoji.txt` is copyright © 2022 Unicode, Inc. and distributed
under the [UNICODE, Inc license agreement][unicode-license].