Provided by: kristall_0.4+dfsg-1_amd64 
NAME
kristall - a cross-platform graphical small-internet client.
SYNOPSIS
kristall [FLAGS]... [URL]
DESCRIPTION
kristall is a small-Internet browser primarily designed for browsing geminispace, but also
supports gopher, finger, and basic HTTP/S. It tries to fill the hole of graphical
browsers for these alternative Internet protocols, with a high usability, feature
richness, and somewhat familiar interface for newcomers.
FLAGS
-h, --help
Displays help information
-v, --version
Displays version information
-w, --new-window
Opens URL in a new window if another Kristall session is already running (instead
of opening a new tab).
-i, --isolated
Starts the instance of Kristall as an isolated session that cannot communicate with
other Kristall windows.
The main interface of Kristall consists of three parts:
* the navigation bar on top,
* the content view in the center
* and the status bar on the bottom
### Navigation bar
In the navigation bar, you have some buttons and your URL bar.
You can enter any supported URL in the URL bar, press IReturn R and Kristall will then
load the page in the content view. You usually need to specify the url scheme to navigate
to a specific site, but you can omit the gemini:// prefix for gemini pages. If you enter a
URL with no scheme, and it looks like a URL (e.g "tilde.pink"), Kristall will assume that
it is in fact a gemini URL. If you enter something in the URL bar that Idoesn't R look
like a URL (e.g "i like dogs"), it will be assumed a search query, and will be forwarded
to the search engine that is set in the Settings.
The two buttons on the left of the navigation bar that give you the ability to navigate
back and forth in your browsing history. The button with the round arrow is the refresh
button and allows you to reload the currently displayed site. While a site is loading, it
is replaced with the stop button (square icon) that allows you to cancel the current
request. Tip: Some additional buttons can also be enabled in the settings, to quickly
navigate to the home page, and even the 'root' and 'parent' of the current URL! (See
BAdditional Toolbar Items R in Settings)
On the right side of the URL bar you will find two buttons:
* The button with the small heart icon in it will add or remove this page to your
favourites, this can be done as well by pressing ICtrl-D R. When the heart on the button
is filled, the site is contained in your favourites. If not, the heart has only a outline
display. Clicking this button will open a small menu to allow you to quickly place the
favourite in a folder of your choosing (by default 'Unsorted'). You can press IReturn R
in this menu to quickly affirm the options displayed in it.
* The button with the shield icon toggles the use of client certificates. Pressing it when
no client certificate is enabled, a dialog will pop up asking you to select or create a
certificate. When a certificate is enabled, the button will have a filled shield with a
small lock in it. Pressing the button now will disable the currently used certificate.
Note that if you're using a transient certificate, Kristall will ask you a safety question
before destroying the certificate.
### Content view
The content view renders the requested document. For hypertext documents (i.e gemtext,
markdown, etc), you get a nicely rendered version of those documents, other text files are
displayed in monospace. Audio and video files are played in a small built-in media player
that allows you to play/pause the media, scroll around in the time line and mute/unmute
audio. Images are rendered in an interactive view where you can drag the image around and
zoom in/out with the mouse wheel.
Documents that can't be rendered will be displayed with file size and mime type, so you
can save them to disk and open the files with another program.
Right-clicking in the content view will produce a menu which allows you to copy text,
navigate back/forward in history, and copy or open links which are being hovered over. If
you right click a HTTP/S link you will also see an option "Open with external web browser"
which allows you to open these pages in your default WWW browser.
### Status bar
The status bar displays auxiliary information:
On the left, you can see the link target when you hover a link. On the right, you can see
the document size, time needed to load the document and the mime type of the content. This
is especially important when Kristall is not able to render the document nicely. A
"(cached)" indicator will appear to the left of the mime type, indicating that the page
has been read from cache.
## Menus
This chapter explains what each menu button does. I hope that most stuff isn't surprising
😉
### File
BNew Tab R will open a new tab to surf.
BNew Window R will open a new window to browse in.
BSave as R allows you to save the currently displayed file to your disk.
BClose Tab R will close the current tab. Does the same as clicking the small (×) button
on the tab itself.
BManage Certificates R will bring up a dialog that allows you to create, delete or change
client certificates.
BSettings R will open a dialog that helps you configure Kristall to your likings.
BQuit R will close Kristall.
### Navigation
This menu contains means to navigate the internet.
BGo to home R will navigate your current tab to your home page.
BBackward R will navigate one page back in your history.
BForeward R will navigate one page foreward in your history.
BRoot R will take you to the root directory of the current site. e.g if you are currently
at gemini://example.com/gemlog/some-document.gmi, you will be taken to
gemini://example.com/
BParent R will take you to the 'parent' directory of the current site. e.g if you are at
gemini://example.com/parent/some-document.gmi, you will be taken to
gemini://example.com/parent/
BRefresh R will reload the current page. This may be necessary for CGI scripts or other
interactive content.
BAdd to favourites R will add or remove the current page to/from your list of favourites.
### View
This menu allows you to show/hide dockable dialogs.
BDocument Outline R toggles the document outline. Documents with text/gemini get an
automatic outline generation that can be used to navigate larger documents quicker. If
you're reading this help document inside of Kristall, this is a good place to try this
feature out!
BFavourites R opens a dock containing a list of all your favourite (a.k.a bookmarked)
sites. Open your favourites into a new tab by double-clicking or pressing IReturn R on
the entries. If you right click on an entry you will be presented with a menu in which you
can edit the name or location of the entry, or delete it. Right-clicking in the window
(not on an entry, not on a group) will allow you to create a new "group" of entries. Right
clicking on a group will allow you to rename the group, or recursively delete it (be
careful!).
BHistory R shows the surfing history of the current tab. Double-clicking an entry
navigates back and forth in your history without disturbing the list.
### Help
This menu contains some stuff that provides help or information about Kristall.
BHelp R displays the help manual (this document).
BChangelog R will open a document that lists the changes in Kristall in a bulleted list.
BAbout R shows a dialog with some information about Kristall.
BAbout Qt R shows a dialog containing legal information about the Qt version used.
## Settings
Kristall offers a vast amount of settings. You can style the documents to your liking,
changing fonts and colors. You can also fine-tune the behaviour of Kristall to match your
likings and keep track of your trusted pages. Please note that Kristall has been designed
mostly for browsing geminispace, thus many of these settings are specific or exclusive to
Gemini only.
### Generic
This tab contains an unsorted list of settings that allow you to tweak Kristalls
behaviour.
BStart Page R is the URL to the page that will be loaded for new tabs and windows.
Default is Babout:favourites R.
BSearch Engine R is the search engine to use when typing non-URLs in the URL bar. A
handful of Gemini search engines are provided as a drop-down. If you would like to specify
your own, specify it in a format similar to the following:
gemini://example.com/search?%1
Note the "%1" at the end of the URL. This is where search queries will be inserted. This
Imust R be provided in order for Kristall to work with the search engine correctly. Be
aware that search engine URLs can vary. For example, a different search engine may appear
like so:
gemini://example2.com/search/another/%1
BAdditional Toolbar Items R contains various additional toolbar items which some may find
useful.
* BHome R button opens the configured home page in the current tab.
* BNew tab R button appears to the right of the tab bar. This simply adds a new tab to
the current window.
* BRoot R button takes you to the root directory of the current site. (See
Menus>Navigation section for explanation of what this does).
* BParent R button takes you to the parent directory of the current site. (See
Menus>Navigation section for explanation of what this does).
BUI Theme R controls whether the Qt interface is displayed in a dark or a light theme.
Selecting BLight R or BDark R will use the provided Qt light/dark themes. BOS Default R
will use your system theme.
BIcon Theme R controls the specific icon set that the Qt interface will use. Usually, the
default BAuto R option should be good enough, however for those using the BOS Default R
UI theme, this option may be useful.
BUI Density R controls the margin of the toolbar buttons.
* BCompact R has a very low margin
* BClassic R has the original big margin
BEnabled Protocols R allows you to fine-tune which protocols are fetched by Kristall. By
default, only Gemini is enabled, all other protocols are disabled. Disabled protocols are
either not served, and produce an error message, or are forwarded to your OS handler for
that URL scheme.
BUnknown Scheme R changes the behaviour how Kristall handles unknown/disabled URL
schemes. BUse OS default handler R will invoke your OS default, BDisplay error message R
will just pop up a message box and tell you that Kristall cannot handle this URL.
BMax. Number of Redirections R is a setting that allows you to restrict sites to redirect
you only a certain number of times before erroring out. Setting this to 0 will disable
redirections completely, displaying an error with the target URL.
BRedirection Handling R allows you to fine-tune the way Kristall allows redirections.
Each of the options defines if Kristall should ask you to allow the redirect or do it
silently. BAsk for cross-scheme redirection R will pop up a message box if a host tries
to redirect you from one URL scheme to another, e.g. when a web server redirects you from
HTTP to HTTPS. BAsk for cross-host redirection R will pop up the message box for all
redirections through host boundaries, e.g. when example.com redirects you to
www.example.com. BAsk for cross-scheme or cross-host redirection R will enable both of
the previous behaviours, asking when any cross-boundary redirection happens. BAsk for all
redirections R will pop up a message box every time a server tries to redirect you,
keeping you in full control over all redirections. BSilently redirect everything R is the
exact oppositve of that, accepting all redirections without warning or notice.
BNetwork Timeout R is the time a server is allowed to Inot respond anything R before a
error message appears. As long as a server dripples some bytes to Kristall, no timeout
will happen, so having a slow or bad connection shouldn't yield timeouts.
### Display
This tabs contains tweaks you can apply to the display behaviour. Change text effects or
rendering of documents.
BRender emojis R allows you to toggle whether to render emojis using installed emoji
fonts. Disabling this can help prevent text rendering issues due to emojis. Note that
emojis are only supported in Kristall builds with Qt 5.13 or later.
BURL bar highlights R sets whether the URL bar should use "fancy" highlights. The
highlighting simply makes the domain of the site more prominent/visible, and the text
around it slightly dimmed. This is purely a cosmetic feature.
BText Rendering R allows one to control whether Kristall parses text input files or not.
This is usually set to BFancy R which renders text/html, text/gemini, text/markdown and
text/gophermap to a nice, hyperlinked display. When set to BAlways plain text R, Kristall
will display all text/* files as plaintext files instead. This may be inconvenient, but
necessary for misparsed sites.
BUse typographer's quotes R sets whether to replace regular quotation marks, that is:
"these", and 'these'
with fancy Unicode quotes, which include the following:
“these”, and ‘these’
This is a purely cosmetic feature that may aid in readability.
BANSI Escape Sequences R determines the method of handling ANSI escape codes. This allows
a document to alter some of the format (colour, etc) of text.
* BIgnore R ignores ANSI sequences and leaves them in the text. This option will often
create eyesores out of pages that have fancy ANSI art!
* BInterpret (preformatted text only) R will allow Kristall to interpret ANSI escape
sequences in Ipreformatted R text blocks.
* BStrip R is a hybrid of the above. It strips ANSI sequences from the text, and displays
the text normally, as if the escape sequences were not there.
BEnable text highlights R allows you to enable Ibolding R and Iunderlining R in
text/gemini documents. Bolding **like this** also works.
BGopher Map R allows you to chose a modern iconized style for gopher maps or, if you are
an old schooler, just use a textual description of the item types in the map.
BHidden files in file:// directories R determines whether hidden files will display in
local directory listings (i.e file:// URLs which do not point to a specific document but
rather a directory).
BStrip <nav> from HTML pages R allows you to remove the <nav> tag from HTML pages. This
might make certain pages more readable, others completely unusable.
### Cache
Kristall employs a small cache system that makes forward/backward navigation much quicker.
This tab provides controls to tweak the caching behaviour.
BTotal cache size limit R sets the total amount of memory that can be used by Kristall to
cache pages. By default this is set to 500 KiB, but can be set to 0 to completely disable
the caching system. The larger this number is, the more memory you are allowing Kristall
to use.
BCached item size threshold R is the maximum size of a single cached item. By default
this is set to 400 KiB. This prevents Kristall from caching any pages that are large from
clogging up the in-memory cache.
BCached item life R is the amount of time in minutes before a single cached item is
considered "expired." When a cached item is "expired", it is not read from cache, but
instead re-retreived from the server. Cache life can be disabled by enabling the
BUnlimited item life R option. Note: BCached item life R is only recommended if you
desperately want to keep your memory usage to a minimum, otherwise, having BUnlimited
item life R is usually a great convenience, and due to the usually very small size of
pages in geminispace, gopherspace, etc - it doesn't require much memory.
### Style
In this tab, you can customise the document rendering in Kristall. The left pane contains
a vast array of options to tweak, and the right pane displays a preview of your currently-
selected style.
Many items in the IStyle R category have either a BFont R, BColor R, or both buttons.
Click these to change the respective value.
BBackground Color R is the color that fills the empty space in a document.
BStandard Font R allows you to change the font that is used for all non-preformatted and
non-heading text. Choose the color and font family/size/style.
BPreformatted Font R is the font and text color that is used for all <pre> tags in HTML
or preformatted blocks in text/gemini. This should be a monospace font, otherwise ASCII
art will break horribly. Note to MacOS X users: "Andale Mono" is a good font choice here.
BH1 Font R allows you to change the font and color for primary headings in documents.
BH2 Font R allows you to change the font and color for secondary headings in documents.
BH3 Font R allows you to change the font and color for ternary headings in documents.
BBlockquote Font R allows you to change the font and colour for blockquotes in documents.
BLocal Link Color R is the color in which links that refer to the same host Iand R
protocol are rendered.
BForeign Link Color R is the color in which links that refer to another host, but the
same protocol are rendered. This helps to recognize when you change the content provider
with a link.
BCross-Scheme-Color R is used for all links that change protocol. For example: If you are
currently visiting a gemini-served page and are referred to a page in gopher space, this
color will be used. This gives you more control over your surfing experience.
BLocal Link Prefix R is a small string that is placed before a link to the same host.
BExtern Link Prefix R is a small string that is placed before a link to a different host.
BBlock Quote Color R is the background color that allows you to highlight block quotes.
BAuto-Theme Generation R is an experimental feature that can be set to BDisabled R,
BLight Theme R and BDark Theme R. When not set to BDisabled R, Kristall will ignore all
your beautiful color settings and tries to create a color scheme based on the current
pages host name. This allows different styles for each host visited and brings some
recognizability in gemini and gopher space.
BLeft/right Page Margin R is the distance of horizontal page content to the left/right
borders. If you have BEnable text width limit R enabled this value is only used when the
window size is less than the set maximum text width.
BTop/bottom Page Margin R is the distance of vertical page content to the top/bottom
borders.
BOther options R are a set of extra options to enhance your reading experience (and just
look cool in general).
* BJustify text R will make text fill the lines they are on. Note that this only works on
gemtext pages.
* BCentre first H1 R will centre-align the first top-level heading in gemtext pages. This
can look really cool with BText width limit R enabled!
BText width limit R sets the maximum line length of text. By default this is set to
900px. If the window itself is smaller in width than the text width limit, the text width
limit is "adjusted" to fit inside the window. As mentioned above, horizontal margins will
also be applied here. The BEnabled R checkbox to the right of this option toggles whether
this option is enabled or not. (Enabled by default)
BLine height (paragraph) R is an additional spacing between paragraph text lines. By
default this is set to 5px, and can help with readability. (Gemtext-only feature)
BLine height (header) R is an additional spacing between header text lines. By default
this is set to 5px. (Gemtext-only feature)
BIndentation R is a set of options that control the level of indent in certain text parts
in Gemini pages.
* BPar R controls indent size of paragraphs (default: 1)
* BHea R controls indent size of headings (default: 0)
* BQuo R controls indent size of blockquotes (default: 1)
* BLst R controls indent size of unordered lists (default: 2)
BIndent Size R is the size in pixels of a single indent. This affects how much of an
effect the above BIndentation R settings have on the layout (default 15).
BList item marker R simply lets you set what symbol is used in list items. By default
this is set to Filled Circle.
BPresets R is a cool feature to save, restore and share your color themes. The dropdown
contains a list of all previously created colors schemes. With the B+ R button you can
create a scheme with a unique name. The floppy disk button will override the currently
selected preset with all the settings displayed above. The folder button will restore a
previously saved preset. The last two buttons allow you to import/export presets to disk
and share them with your friends! Share all your beautiful color schemes with the world!
The lone text with with the Bhost.name R text in it can be used to preview some auto-
generated themes. It only refreshes the preview and seeds the auto generator with a new
host name.
### Gemini TLS and HTTPS TLS
These two sites contain the TLS settings for either Gemini or HTTPS. Both protocols are
handled in the same way, but with different data sets, so each one has its own settings
page.
BTrust Level R defines how you trust hosts. BTrust on first encounter R is also known as
ITrust On First Use R (or TOFU) and will store the servers public key in Kristalls
database of trusted hosts. If a host is later encountered that has changed its public key,
an error will be displayed to the user that this host may be compromised (as the changing
of a public key can be a man-in-the-middle attack). BTrust everything R will just happily
accept every TLS server, ignoring the certificate issuer completely. BManually verify
fingerprints R allows you to chose whether you trust a server or not based on its
fingerprint. This will be displayed in the error page as well as the option to add that
server to your list of trusted hosts.
BCertificate Authorities R allows you to enable/disable the use of your systems CA trust
store. Sites that can be enabled via the CA system will not be added to the list of
trusted hosts (as it is only meant for TOFU/manual implementation), but will not error
out. BUse local certificate authorities R will enable that behaviour, BDon't use local
certificate authorities R will disable it.
BTrusted Hosts R displays your database of currently trusted hosts for either Gemini or
HTTPS servers. You can see the host name (which is used for identification), the date when
you trusted the server and the type of the key that server is using.
BRevoke trust R allows you to remove a server from your database. Select a server in the
list and click the button. Kristall will now act as it hasn't ever seen that server before
and will now handle the server as an unknown one.
## Certificate Manager
This dialog allows you to manage your client certificates. There are options to import,
export, delete and create new certificates as well as manage your existing ones.
The window is separated in two halves:
The left half is the overview over your certificates and your available actions.
The right half contains information about the currently selected certificate.
The overview displays your certificates managed in groups. Each certificate is contained
in a group that allows you to structure your certificates better. Good groups for example
is IAccounts R, IAccess Token R, IGames R, ... You can move certificates between
different groups by using drag'n'drop. Just click the certificate and drag it over into
another group.
When selecting a certificate, its details are displayed on the right side of the screen:
BDisplay Name R is the text you will see in the overview on the left and on the smaller
dialog selection screen. You can type in here whatever you want, it's just for you. It's
possible to edit this value.
BCommon Name R is the CN value that was used when creating the certificate. Its used as a
identifier and the only required field when creating the cert. You cannot change this.
BExpiration Date R is the date when your certificate expires.
BExpires in R shows the numbe of days until your certificate expires. This may be more
intuitive to work with, but communicating the expiration date is recommended.
BHost Filter R is a security-measurement to shield you from accidental identity exposure.
You can type in a URL with wildcards, using ? for a single character, * for any number of
characters, including zero and B… R for allowing a set of certain characters to be
matched. When you try activating the certificate on a URL that does not match your Host
Filter, Kristall will ask you if you really want to enable the certificate. This prevents
you from accidentally using the certificate on a host or URL where it shouldn't be used.
BAuto-Enable Certificate R is built on top of the Host Filter. When you don't have a
client certificate enabled Iand R you visit a URL that matches the Host Filter property,
Kristall will ask you if you want to enable that certificate. This is convenient when you
need a certificate to visit that location anyways and this allows you to quickly enable
your default certificate.
BFingerprint R is the SHA256 fingerprint of this certificate.
BNotes R is a free-form text field for your private use. Kristall does not use this value
what-so-ever. Use this field to make notes about that certificate.
You can find more information about the wildcard syntax here:
Wildcard Matching: https://doc.qt.io/qt-5/qregexp.html#qregexp-wildcard-matching
Below the certificate overview are four buttons, described from left to the right:
BCreate certificate R will open up the certificate creation dialog and allows you to
create a new certificate.
BImport certificate R will open up the certificate i/o dialog. This allows you to import
a existing certificate/key pair, supporting RSA and EC cryptography as well as PEM/DER
encoded files.
BExport certificate R will open up the certificate i/o dialog. This allows you to export
the currently selected certificate into a certificate/key pair. This allows PEM/DER
encoded files and you should remember/note what kind of format your key has. Exporting
allows you to back up you keys, change to another browser or share them with your friends
(don't!).
BDelete certificate R will delete the currently selected certificate or group. You will
get a security pop-up when deleting a certificate as this is a non-reversable operation
(unless you made a back-up). Deleting empty groups is always allowed without pop-up,
deleting non-empty groups is not allowed.
Using passphrases for importing/exporting certificates is currently not supported.
Please note that changes in this dialog are immediaty applied and there is no way back
when doing an action. This may change in the future, but will stay like this for now.
## Certificate Selection Dialog
This dialog allows you to enable client certificates. It is opened by clicking the shield
button in the navigation bar or it will automatically pop up when a site requests the use
of a client certificate.
In the upper part, this dialog provides you with a list of all your persistent
certificates. If you want to use one of those, select the certificate and click BUse R.
Or simply double-click a certificate to chose it.
You can also ad-hoc create a new certificate with the click on BCreate new identity R.
This will open up the certificate creation dialog which allows you to create new
identities.
On the lower part you can create temporary certificates that have a short lifespan and
will be destroyed as soon as you disable the certificate or close your client.
## Certificate Creation Dialog
This dialog provides means to create a new persistent identity.
BGroup R is the name of the group where this certificate should be stored. You can either
chose an existing group from the drop down or just enter a non-existing name to create a
new group ad-hoc.
BDisplay Name R is the title of the certificate that Kristall will show you. It will not
be sent to a server ever.
BCommon Name R is the CN field in the X509 certificate. It's required for identitication
to the hosts.
BExpiration Date R is the date when your certificate becomes invalid. Kristall choses a
default of "1 year from now on", but you can chose any time you want, even just 30
minutes. Better chose a long time though if you don't know how long you need that
certificate.
With a click on BOK R, Kristall will create a new certificate and put it in your
certificate store. It can then be selected from the certificate selection dialog or
certificate manager.
## Certificate I/O Dialog
This dialog enables you to import or export certificate-key-pairs into or from Kristall.
BKey Type R contains the type of your key. If you import, you need to select the correct
key type there, if you export, it will be disabled, but shows the correct type of key for
your identity.
BKey File R needs to be a full path to either a .der or .pem file where Kristall will
load/store the key from/to.
BCertificate File R needs to be a full path to either a .der or .pem file where Kristall
will load/store the certificate from/to.
## Shortcuts
The following list contains all of Kristall's built-in shortcuts:
* Ctrl+T ⇒ New tab
* Ctrl+N ⇒ New window
* Ctrl+W ⇒ Close tab
* Ctrl+D ⇒ Quick add/remove from favourites
* Ctrl+L ⇒ Focus URL bar
* Ctrl+S ⇒ Save current file
* Ctrl+B ⇒ Toggle favourites dock
* Ctrl+H ⇒ Toggle history dock
* Ctrl+M ⇒ Toggle document outline dock
* Ctrl+U ⇒ View document source
* Ctrl+Q ⇒ Quit Kristall
* Ctrl+, ⇒ Open settings window
* Alt+Left ⇒ Navigate one page back
* Alt+Right ⇒ Navigate one page forward
* Alt+Up ⇒ Navigate to parent directory
* Alt+Home ⇒ Go to home page
* Alt+/ ⇒ Navigate to root directory
* F1 ⇒ Open help manual
* F5 ⇒ Refresh current tab
## Protocol support
These protocols are currently supported via their respective URL schemes:
Gemini: https://gemini.circumlunar.space/
HTTP/HTTPS: https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol
Gopher: https://en.wikipedia.org/wiki/Gopher_(protocol)
Finger: https://en.wikipedia.org/wiki/Finger_protocol
### Gemini
Kristall tries to implement the current feature set of the gemini specification. All
response types of a gemini server are relayed to the user and the user choses when to do
certain actions or not. Redirections are followed automatically, and you will be prompted
depending on your configured Settings.
### Gopher
Kristall provides access to gopherspace and supports most modern/common file types:
* Gophermaps / Directories
* Text
* Sound / Audio / Music
* Images / GIFs
* HTML
* Mirrors
There is currently no support for automatic redirection on URL: resources or
special/oldschool file types like DOS/HexBin/UUencoded data.
### Local file browsing
The file:// scheme can be used to browse local files and directories on your system. (This
feature has not been well-tested on Windows systems)
Browsing to a local directory, such as file:///home/user will create a "directory
listing", with links allowing you to navigate the file structure.
Browsing to an actual file, such as file:///home/user/file.txt will cause Kristall to
attempt to display that file.
### Built-in sites
There is also the scheme about: which can be used to access internal sites for
configuration, usability or help (this is one of them!):
about:blank
about:favourites
about:help
about:updates
about:style-preview
about:style-display
about:cache
## Security Concept
Kristall has some built-in security measures to make your browsing experience safe and
sane.
### Philosophy
Kristall will always try to warn or ask you if anything critical will happen.
Sneakily redirecting you to another host?
You missed disabling your client certficiate when switching hosts?
Kristall will ask you whether you want to keep your current settings and continue or if
you want to disable that feature. These security measures are quite non-intrusive and help
you "not missing the click".
It will also make some artificial hurdles when you can Ireally R make something that is
critical, like visiting a host with a mistrusted certificate or deleting your client
certificates.
### Security Measures
* Client certificates will be disabled when doing a host or protocol switch
* Client certificates allow host filtering to double-opt-in for non-planned hosts
* Redirects check for cross-scheme or cross-host redirections.
* Fine-grained customizations
* Trusting TLS connections based on manually built lists, TOFU method or using the
certificate authority system
## Caching
Kristall has an in-memory page caching system enabled by default. This allows for quick
loading of pages that have already been visited. Currently, this cache is cleared when
Kristall is exited.
The caching system is fairly basic; when a page is loaded, it is pushed to the cache (if
it is smaller than BCached item size threshold R). If the cache exceeds the BTotal cache
size limit R, the oldest item in the cache is removed. The BCached item life R determines
how long this cached pages will be valid for.
When a page is read from cache, it is indicated in the Status Bar, to the left of the mime
type.
If you would like to disable page caching, set the BTotal cache size limit R to 0. See
ISettings R for more information
## Supported Media Types
* text/plain
* text/gemini
* text/html
* application/xhtml+xml
* text/markdown
* text/gophermap
BUGS
Bug tracker:
https://github.com/MasterQ32/kristall/issues