Home

Awesome

ereandel

print

A Gemini web browser using shell script

Installing

Debian and Archlinux have packages that can be installed via their package system, see the next section if you want.

You can also move the file ereandel to a folder in your PATH variable, or run make install, by default it will be installed into ~/.local/bin. Use PREFIX to override the install location, e.g.

Packages

I'm not the maintainer of the distro packages for this project, if you want to package please go ahead. Currently Ereandel is packaged for:

Packages can be found and installed using your distro's package system.

Status

ereandel ereandel-git unstable testing

Using

Start browsing by running ereandel with an optional URL:

ereandel gemini://rawtext.club:1965/~sloum/spacewalk.gmi

you can omit the protocol and port:

ereandel rawtext.club/~sloum/spacewalk.gmi

no arguments takes you to gemini.circumlunar.space:

ereandel

Client certificates

ereandel can work with client certificates if capsules requires them for authentication.

ereandel allows a single client certificate per (sub)domain identified by it's name. If a client cert for a specific domain is available ereandel will send it to the server with every request.

When a resource requires a client cert and ereandel can't find one it will show you a command to create a client cert for the capsule. The certificates are stored in ~/.config/ereandel/certs/.

To remove a certificate simply delete the <domain>.crt and <domain>.key files in the directory mentioned above.

Key bindings

More coming.

Configuration

You can setup a config file at ~/.config/ereandel/ereandel.conf to configure ereandel the way you like.

The file uses a simple key=value style, see the complete example for the default values below.

hints:

margin=8
homepage="gemini.circumlunar.space/"
sty_header1='\033[35;7;1m'
sty_header2='\033[35;4;1m'
sty_header3='\033[35;4m'
sty_quote='\033[2;3m  '
sty_linkb='\033[35m'
sty_linkt=' => \033[36;3m '
sty_listb='\033[35;1m  •'
sty_listt='\033[0m'

Meta

Further works

Contributing

Please read the contributing file.

Inspired by