ereandel(1) · carta

Usage

ereandel {[URL] | [OPTION]}

Overview

ereandel v0.26.0: Browse the gemini web on any POSIX compatible terminal.

Options

-h, --help: show this help

-v, --version: show version info

Commands

These are the default keybindings to use while running ereandel:

q: quit

g: go to a link

r: reload current page

b: go back one page

u: jump one path segment up

o: open an address

s: save current page

H: go to homepage

m: add bookmark

M: go to a bookmark

K: remove bookmark for current url

Environment

Ereandel uses 2 environment variables to help debugging and tracing its execution.

debug: To start ereandel in debug mode

trace: To start ereandel with tracing activated

Notes

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 $XDG_CONFIG_DIR/ereandel/certs/.

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

Configuration

You can setup a config file at $XDG_CONFIG_DIR/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.

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'
openkey='o'
openlocalkey='O'
gokey='g'
refreshkey='r'
backkey='b'
quitkey='q'
markkey='b'
gomarkkey='M'
delmarkkey='K'
goupkey='u'
homekey='H'

Examples

ereandel: Start browsing the default webpage

ereandel url: Start browsing url

ereandel --help: Show help