about summary refs log tree commit diff stats
path: root/bollux.1
blob: a0986154248eacb35fb34992e6bef92d679e6ab0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
\" -*- nroff -*-
.TH bollux 1 0.4.0
.SH NAME
bollux \- gemini protocol browser written in
.BR bash (1)
.SH SYNOPSIS
.B bollux
.RI [ \-h ]
.TP
.B bollux
.RI [ \-q ]
.RI [ \-v ]
.\".RI [ \-c
.\".BR CONFIG ]
.RB [ URL ]
.SH DESCRIPTION
.BR bollux (1)
is a browser for the new Gemini protocol, which aims to be
"heavier than gopher, but lighter than the web."
It can follow links, collect user input, download files, and display text/* mimetype pages in geminispace.
.SH OPTIONS
.TP
.B \-h
Display an inline help screen and exit
.TP
.B \-q
Be quiet: don't show any messages, even fatal ones
.TP
.B \-v
Be verbose: show all messages, even debug ones
.\".TP
.\".B \-c CONFIG
.\"Use CONFIG file to configure
.\".BR bollux (1)
.\"instead of the default: $XDG_CONFIG_HOME/bollux/bollux.conf.
.TP
.B URL
The gemini URL to navigate to
.SH USAGE
If
.BR bollux (1)
is invoked with a URL, it will download or display that URL.
Otherwise, the user will be prompted for a URL to download or display.
If the URL points to a text/* document, it is paged with
.BR less (1)
with custom keybinds:
.TP
.B o
open a link on the current page
.TP
.B g
goto a new URL
.TP
.B G
goto a new URL - with current URL pre-filled
.TP
.B r
refresh the current page
.TP
.B p
cycle preformatted text visibility and refresh the current page
.TP
.B [
goto the previous page in history
.TP
.B ]
goto the next page in history
.TP
.B q
quit bollux
.TP
.B \=
show a short help message
.PP
If a new URL is selected,
.BR bollux (1)
will repeat the download-and-display loop with the new URL.
.PP
If the mimetype is other than text/*,
.BR bollux (1)
will attempt to download the file to
.B $BOLLUX_DOWNDIR
(which defaults to '.').
.PP
.BR bollux (1)
also supports the gopher protocol,
which is browsed the same way as the gemini protocol
(except the URL starts with 'gopher://').
Gopher support is as of now rudimentary.
.SH ISSUES
Certificate handling needs to be much improved: TOFU needs to be implemented
and bollux should be able to generate client certificates.
.SH SEE ALSO
.BR bollux.conf (5)
.SH BUGS
The development repo is located at https://sr.ht/~acdw/bollux.
Please direct all bug reports, patches, or general complaints there.