Keyboard shortcuts

  • F4 to focus the address bar and type an address; F2 show its menu

  • Ctrl + Left/Right - go back/forward

  • Ctrl + T - new tab

  • Ctrl + X - close tab

  • Ctrl + O/P - previous tab/next tab

  • Ctrl + Shift + O/P - move tab left/right

  • Ctrl + B - show/hide bookmarks

  • Ctrl + D - show/hide downloads

Subwindows

A subwindow is a multiple document interface window that contains a collection of tabs and has a default profile. It can be minimized, resized, moved, maximized, tiled (F9) and cascaded (F10) within the main window.

  • Ctrl + G - new subwindow

  • Ctrl + W - close subwindow

Profiles

A Profile is a collection of settings, policies, scripts, cookies, cache and history. Profiles can be used to isolate pages from each other.

Each window has a default profile it uses when opening new tabs. This can be changed from the window’s menu. Additionally, tabs can have their profiles individually changed from their context menu.

Because profiles store all their data separately, you can log in into the same site with a different account from each profile. However, links opened into new tabs will still use the subwindow’s default profile. For example, you can set a profile to hold login information for a site, but all new tabs opened from that site would still be using the default off-the-record profile.

Profiles are read from profile.path

Settings

  • otr (defaults to true) - is this profile off-the-record

  • name (defaults to the configuration file name)

  • search (defaults to profile.search) - search engine url

  • homepage (defaults to profile.homepage)

  • newtab (defaults to profile.newtab)

Properties Key is property name; value is property value

Attributes see QWebEngineSetting::WebAttribute for list of IDs. Key is attribute id; value is attribute value (true/false)

Configuration

The Configuration is loaded from .config/smolbote/smolbote.cfg. Most settings are only loaded on launch.

For a full list of settings, check '--help'.

You can overwrite options at runtime using the option path as a command line parameter.

  • Browser (group: browser)

  • Main Window (group: mainwindow) A main window contains one or more subwindows.

  • Subwindow (group: window) A subwindow contains multiple tabs and functions similarly to a tab group.

  • Navigation bar (group: navigation) 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.

  • Address bar (group: addressbar)

  • Filter (group: filter)

  • Plugins (group: 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, or set its absolute path as the plugins.path.

  • Profiles (group: profile) A Profile is a collection of settings, policies, scripts, cookies, cache and history. Profiles can be used to isolate pages from each other.

Each window has a default profile it uses when opening new tabs. This can be set by the profile.default option, and can be changed from the window’s menu. Additionally, tabs can have their profiles individually changed from their page menu.

Because profiles store all their data separately, you can log in into the same site with a different account from each profile. However, links opened into new tabs will still use the subwindow’s default profile. For example, you can set a profile to hold login information for a site, but all new tabs opened from that site would still be using the default off-the-record profile.

Profile definitions are stored in the profiles.path location. To create a new profile, create a profile-id.profile file in that location.

  • Bookmarks (group: bookmarks)

  • Downloads (group: downloads)