qbrsh 0.2.0

A fast, keyboard-driven web browser
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

# Configuration

qbrsh reads `~/.config/qbrsh/config.toml`. Every field is optional and falls
back to a default, so you only set what you want to change.

```toml
homepage = "https://duckduckgo.com"

[colors]
background = "#1a1a2e"
foreground = "#e0e0e0"
accent = "#ffd76e"

[font]
family = "monospace"
size = 11

[permissions]
default = "deny"

[permissions.sites]
"example.com" = "allow"
```

## Sections

### homepage

The page opened on startup when no URL is passed on the command line.

### colors and font

Theme the chrome (tab bar, status bar, command line, completion popup). Colors
are any CSS color string; the font applies to the chrome, not page content.

### permissions

A default policy plus per-site overrides for geolocation, notifications, and
media requests. See [Permissions](/guide/permissions).

## Changing settings at runtime

Use the `:set` command to change a value live:

```
:set colors.accent #ff5f5f
:set font.size 13
:set permissions.example.com allow
```

Reload the file from disk at any time with `:config-source`. There is no file
watcher; reloading is explicit and deterministic.