1. smolbote(7)
3. smolbote(7)

NAME

smolbote - yet another no-frills browser

SYNOPSIS

poi [options...] URL(s)

DESCRIPTION

smolbote is a keep-it-simple free software web browser.

COMMAND-LINE OPTIONS

General

• -h, --help: Display this help.
• -v, --version: Display version information.
• --build: Display build branch and commit.

Configuration

• -c, --config: Set configuration file.
• --socket: Local server socket

Plugins

• --command: Run a plugin command.
• --commands: List all plugin commands.

CONFIGURATION

The Configuration is loaded from ~/.config/smolbote/smolbote.cfg, and can be edited with the poi-config tool.

Settings are only loaded on launch; re-run the browser to apply changes.

Browser

• browser.stylesheet: path

Main Window

A main window contains one or more subwindows.

• mainwindow.height: 720
• mainwindow.width: 1280
• mainwindow.maximized: true
• mainwindow.title: smolbote
• mainwindow.shortcuts.newGroup: Ctrl+G
• mainwindow.shortcuts.newWindow: Ctrl+N
• mainwindow.shortcuts.about: F1
• mainwindow.shortcuts.quit: Ctrl+Q
• mainwindow.shortcuts.search: F3
• mainwindow.shortcuts.tileWindows: F9
• mainwindow.shortcuts.cascadeWindows: F10

Subwindow

A subwindow contains multiple tabs and functions similarly to a tab group.

• window.shortcuts.new: Ctrl+T
• window.shortcuts.close: Ctrl+X
• window.shortcuts.left: Ctrl+O
• window.shortcuts.right: Ctrl+P
• window.shortcuts.fullscreen: F11

Navigation bar

The navigation bar is the toolbar that holds the history, reload and home buttons, as well as the address bar. It can be made movable through the navigation.movable option.

• navigation.movable: false
• navigation.shortcuts.back: Ctrl+Left
• navigation.shortcuts.forward: Ctrl+Right
• navigation.shortcuts.refresh: F5
• navigation.shortcuts.reload: Ctrl+F5
• navigation.shortcuts.home: Ctrl+Home

Address bar

• addressbar.shortcuts.focus: F4
• addressbar.shortcuts.menu: F2

Filter

• filter.path: ~/.config/smolbote/hosts.d
• filter.cookies.block.all: false (todo: in qt5.11)
• filter.cookies.block.thirdParty: true
• filter.cookies.path: ~/.config/smolbote/cookies.d

Plugins

Plugins a way of extending smolbote's functionality using the Qt plugin system. They are not to be confused with NPAPI/PPAPI or WebExtension plugins.

To enable a plugin either copy it or symlink it in the plugins.path location. A set of default plugins is installed in /usr/lib/smolbote.

• plugins.path: ~/.config/smolbote/plugins.d

Profiles

• profile.default: ''
• profile.path: ~/.config/smolbote/profiles.d
• profile.search: https://duckduckgo.com/?q=%1&ia=web
• profile.homepage: about:blank
• profile.newtab: about:blank

Bookmarks

• bookmarks.path: ~/.config/smolbote/bookmarks.xbel
• bookmarks.shortcut: Ctrl+B

Downloads

• downloads.path: ~/Downloads
• downloads.shortcut: Ctrl+D

2. May 2018
3. smolbote(7)