<!DOCTYPE html>
<html>
<head>
<meta http-equiv='content-type' value='text/html;charset=utf8'>
<meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
<title>smolbote(7) - yet another no-frills browser</title>
<style type='text/css' media='all'>
/* style: man */
body#manpage {margin:0}
.mp {max-width:100ex;padding:0 9ex 1ex 4ex}
.mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
.mp h2 {margin:10px 0 0 0}
.mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
.mp h3 {margin:0 0 0 4ex}
.mp dt {margin:0;clear:left}
.mp dt.flush {float:left;width:8ex}
.mp dd {margin:0 0 0 9ex}
.mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
.mp pre {margin-bottom:20px}
.mp pre+h2,.mp pre+h3 {margin-top:22px}
.mp h2+pre,.mp h3+pre {margin-top:5px}
.mp img {display:block;margin:auto}
.mp h1.man-title {display:none}
.mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
.mp h2 {font-size:16px;line-height:1.25}
.mp h1 {font-size:20px;line-height:2}
.mp {text-align:justify;background:#fff}
.mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
.mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
.mp u {text-decoration:underline}
.mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
.mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
.mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
.mp b.man-ref {font-weight:normal;color:#434241}
.mp pre {padding:0 4ex}
.mp pre code {font-weight:normal;color:#434241}
.mp h2+pre,h3+pre {padding-left:0}
ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
ol.man-decor {width:100%}
ol.man-decor li.tl {text-align:left}
ol.man-decor li.tc {text-align:center;letter-spacing:4px}
ol.man-decor li.tr {text-align:right;float:right}
</style>
</head>
<!--
The following styles are deprecated and will be removed at some point:
div#man, div#man ol.man, div#man ol.head, div#man ol.man.
The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
.man-navigation should be used instead.
-->
<body id='manpage'>
<div class='mp' id='man'>
<div class='man-navigation' style='display:none'>
<a href="#NAME">NAME</a>
<a href="#SYNOPSIS">SYNOPSIS</a>
<a href="#DESCRIPTION">DESCRIPTION</a>
<a href="#COMMAND-LINE-OPTIONS">COMMAND-LINE OPTIONS</a>
<a href="#CONFIGURATION">CONFIGURATION</a>
</div>
<ol class='man-decor man-head man head'>
<li class='tl'>smolbote(7)</li>
<li class='tc'></li>
<li class='tr'>smolbote(7)</li>
</ol>
<h2 id="NAME">NAME</h2>
<p class="man-name">
<code>smolbote</code> - <span class="man-whatis">yet another no-frills browser</span>
</p>
<h2 id="SYNOPSIS">SYNOPSIS</h2>
<p><code>poi</code> [<var>options</var>...] URL(s)</p>
<h2 id="DESCRIPTION">DESCRIPTION</h2>
<p>smolbote is a keep-it-simple free software web browser.</p>
<h2 id="COMMAND-LINE-OPTIONS">COMMAND-LINE OPTIONS</h2>
<h3 id="General">General</h3>
<ul>
<li><code>-h</code>, <code>--help</code>: Display this help.</li>
<li><code>-v</code>, <code>--version</code>: Display version information.</li>
<li><code>--build</code>: Display build branch and commit.</li>
</ul>
<h3 id="Configuration">Configuration</h3>
<ul>
<li><code>-c</code>, <code>--config</code>: Set configuration file.</li>
<li><code>--socket</code>: Local server socket</li>
</ul>
<h3 id="Plugins">Plugins</h3>
<ul>
<li><code>--command</code>: Run a plugin command.</li>
<li><code>--commands</code>: List all plugin commands.</li>
</ul>
<h2 id="CONFIGURATION">CONFIGURATION</h2>
<p>The Configuration is loaded from <em>~/.config/smolbote/smolbote.cfg</em>, and can be
edited with the <code>poi-config</code> tool.</p>
<p>Settings are only loaded on launch; re-run the browser to apply changes.</p>
<h3 id="Browser">Browser</h3>
<ul>
<li>browser.stylesheet: path</li>
</ul>
<h3 id="Main-Window">Main Window</h3>
<p>A main window contains one or more subwindows.</p>
<ul>
<li>mainwindow.height: 720</li>
<li>mainwindow.width: 1280</li>
<li>mainwindow.maximized: true</li>
<li>mainwindow.title: smolbote</li>
<li>mainwindow.shortcuts.newGroup: Ctrl+G</li>
<li>mainwindow.shortcuts.newWindow: Ctrl+N</li>
<li>mainwindow.shortcuts.about: F1</li>
<li>mainwindow.shortcuts.quit: Ctrl+Q</li>
<li>mainwindow.shortcuts.search: F3</li>
<li>mainwindow.shortcuts.tileWindows: F9</li>
<li>mainwindow.shortcuts.cascadeWindows: F10</li>
</ul>
<h3 id="Subwindow">Subwindow</h3>
<p>A subwindow contains multiple tabs and functions similarly to a tab group.</p>
<ul>
<li>window.shortcuts.new: Ctrl+T</li>
<li>window.shortcuts.close: Ctrl+X</li>
<li>window.shortcuts.left: Ctrl+O</li>
<li>window.shortcuts.right: Ctrl+P</li>
<li>window.shortcuts.fullscreen: F11</li>
</ul>
<h3 id="Navigation-bar">Navigation bar</h3>
<p>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.</p>
<ul>
<li>navigation.movable: false</li>
<li>navigation.shortcuts.back: Ctrl+Left</li>
<li>navigation.shortcuts.forward: Ctrl+Right</li>
<li>navigation.shortcuts.refresh: F5</li>
<li>navigation.shortcuts.reload: Ctrl+F5</li>
<li>navigation.shortcuts.home: Ctrl+Home</li>
</ul>
<h3 id="Address-bar">Address bar</h3>
<ul>
<li>addressbar.shortcuts.focus: F4</li>
<li>addressbar.shortcuts.menu: F2</li>
</ul>
<h3 id="Filter">Filter</h3>
<ul>
<li>filter.path: ~/.config/smolbote/hosts.d</li>
<li>filter.cookies.block.all: false (todo: in qt5.11)</li>
<li>filter.cookies.block.thirdParty: true</li>
<li>filter.cookies.path: ~/.config/smolbote/cookies.d</li>
</ul>
<h3 id="Plugins">Plugins</h3>
<p>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.</p>
<p>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.</p>
<ul>
<li>plugins.path: ~/.config/smolbote/plugins.d</li>
</ul>
<h3 id="Profiles">Profiles</h3>
<ul>
<li>profile.default: ''</li>
<li>profile.path: ~/.config/smolbote/profiles.d</li>
<li>profile.search: https://duckduckgo.com/?q=%1&ia=web</li>
<li>profile.homepage: about:blank</li>
<li>profile.newtab: about:blank</li>
</ul>
<h3 id="Bookmarks">Bookmarks</h3>
<ul>
<li>bookmarks.path: ~/.config/smolbote/bookmarks.xbel</li>
<li>bookmarks.shortcut: Ctrl+B</li>
</ul>
<h3 id="Downloads">Downloads</h3>
<ul>
<li>downloads.path: ~/Downloads</li>
<li>downloads.shortcut: Ctrl+D</li>
</ul>
<ol class='man-decor man-foot man foot'>
<li class='tl'></li>
<li class='tc'>May 2018</li>
<li class='tr'>smolbote(7)</li>
</ol>
</div>
</body>
</html>