ereandel

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:

Archlinux AUR thanks to guzzisti
Debian thanks to Akash Doppalapudi

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

Status

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

b to go back one page
u go one path segment up
o to open a new URL, you'll be prompted to type it
r to reload the page
H to go to the home page
g to follow a link in the current page, a link will be displayed, and
s to save the page to a file
m to add the current page to bookmarks
M to go to a bookmark
K to delete the bookmark of the current page
q to quit

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:

ereandel will be appended to cachehome, the directory must be writable for your user.
The style- keys must be ANSI style codes.

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'

Themes

You can customize the appearance of ereandel by using different themes. Here are some predefined themes you can use:

Dark Theme

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'

Light Theme

sty_header1='\033[30;7;1m'
sty_header2='\033[30;4;1m'
sty_header3='\033[30;4m'
sty_quote='\033[2;3m  '
sty_linkb='\033[30m'
sty_linkt=' => \033[34;3m '
sty_listb='\033[30;1m  •'
sty_listt='\033[0m'

Solarized Theme

sty_header1='\033[38;5;136;7;1m'
sty_header2='\033[38;5;136;4;1m'
sty_header3='\033[38;5;136;4m'
sty_quote='\033[2;3m  '
sty_linkb='\033[38;5;136m'
sty_linkt=' => \033[38;5;141;3m '
sty_listb='\033[38;5;136;1m  •'
sty_listt='\033[0m'

Ereandel

Install / Use

README