1
0
mirror of https://github.com/makew0rld/amfora.git synced 2024-12-04 14:46:29 -05:00
amfora/config/default.go

440 lines
14 KiB
Go
Raw Normal View History

2020-06-18 16:54:48 -04:00
package config
2020-07-28 16:58:32 -04:00
//go:generate ./default.sh
2020-06-18 16:54:48 -04:00
var defaultConf = []byte(`# This is the default config file.
# It also shows all the default values, if you don't create the file.
# You can edit this file to set your own configuration for Amfora.
# When Amfora updates, defaults may change, but this file on your drive will not.
# You can always get the latest defaults on GitHub.
# https://github.com/makeworld-the-better-one/amfora/blob/master/default-config.toml
# Please also check out the Amfora Wiki for more help
# https://github.com/makeworld-the-better-one/amfora/wiki
# gemini://makeworld.space/amfora-wiki/
2020-06-18 16:54:48 -04:00
2020-06-20 17:17:34 -04:00
# All URL values may omit the scheme and/or port, as well as the beginning double slash
# Valid URL examples:
# gemini://example.com
# //example.com
# example.com
# example.com:123
2020-06-18 16:54:48 -04:00
2020-08-06 13:55:43 -04:00
2020-06-18 16:54:48 -04:00
[a-general]
2020-08-05 13:31:59 -04:00
# Press Ctrl-H to access it
home = "gemini://geminiprotocol.net"
2020-06-20 17:17:34 -04:00
# Follow up to 5 Gemini redirects without prompting.
# A prompt is always shown after the 5th redirect and for redirects to protocols other than Gemini.
# If set to false, a prompt will be shown before following redirects.
auto_redirect = false
2020-11-04 18:35:56 -05:00
# What command to run to open a HTTP(S) URL.
# Set to "default" to try to guess the browser, or set to "off" to not open HTTP(S) URLs.
2020-06-18 16:54:48 -04:00
# If a command is set, than the URL will be added (in quotes) to the end of the command.
2020-11-04 18:35:56 -05:00
# A space will be prepended to the URL.
#
# The best way to define a command is using a string array.
2020-11-04 18:35:56 -05:00
# Examples:
# http = ['firefox']
# http = ['custom-browser', '--flag', '--option=2']
# http = ['/path/with spaces/in it/firefox']
2020-11-04 18:35:56 -05:00
#
# Note the use of single quotes, so that backslashes will not be escaped.
# Using just a string will also work, but it is deprecated, and will degrade if
# you use paths with spaces.
2020-11-04 18:35:56 -05:00
http = 'default'
2020-08-05 13:31:59 -04:00
# Any URL that will accept a query string can be put here
search = "gemini://geminispace.info/search"
2020-08-05 13:31:59 -04:00
# Whether colors will be used in the terminal
color = true
# Whether ANSI color codes from the page content should be rendered
ansi = true
# Whether or not to support source code highlighting in preformatted blocks based on alt text
highlight_code = true
# Which highlighting style to use (see https://xyproto.github.io/splash/docs/)
highlight_style = "monokai"
2020-08-05 13:31:59 -04:00
# Whether to replace list asterisks with unicode bullets
bullets = true
# Whether to show link after link text
show_link = false
2020-08-05 13:31:59 -04:00
# The max number of columns to wrap a page's text to. Preformatted blocks are not wrapped.
2021-12-22 20:36:12 -05:00
max_width = 80
2020-08-05 13:31:59 -04:00
# 'downloads' is the path to a downloads folder.
# An empty value means the code will find the default downloads folder for your system.
2020-07-09 19:28:39 -04:00
# If the path does not exist it will be created.
# Note the use of single quotes, so that backslashes will not be escaped.
downloads = ''
2020-08-05 13:31:59 -04:00
# Max size for displayable content in bytes - after that size a download window pops up
page_max_size = 2097152 # 2 MiB
# Max time it takes to load a page in seconds - after that a download window pops up
page_max_time = 10
# When a scrollbar appears. "never", "auto", and "always" are the only valid values.
# "auto" means the scrollbar only appears when the page is longer than the window.
scrollbar = "auto"
# Underline non-gemini URLs
# This is done to help color blind users
underline = true
2020-08-27 22:40:40 -04:00
[auth]
# Authentication settings
# Note the use of single quotes for values, so that backslashes will not be escaped.
[auth.certs]
# Client certificates
# Set URL equal to path to client cert file
#
# "example.com" = 'mycert.crt' # Cert is used for all paths on this domain
# "example.com/dir/"= 'mycert.crt' # Cert is used for /dir/ and everything below only
#
# See the comment at the beginning of this file for examples of all valid types of
# URLs, ports and schemes can be used too
[auth.keys]
# Client certificate keys
# Same as [auth.certs] but the path is to the client key file.
2020-08-06 13:55:43 -04:00
[keybindings]
# If you have a non-US keyboard, use bind_tab1 through bind_tab0 to
# setup the shift-number bindings: Eg, for US keyboards (the default):
# bind_tab1 = "!"
# bind_tab2 = "@"
# bind_tab3 = "#"
# bind_tab4 = "$"
# bind_tab5 = "%"
# bind_tab6 = "^"
# bind_tab7 = "&"
# bind_tab8 = "*"
# bind_tab9 = "("
# bind_tab0 = ")"
# Whitespace is not allowed in any of the keybindings! Use 'Space' and 'Tab' to bind to those keys.
# Multiple keys can be bound to one command, just use a TOML array.
# To add the Alt modifier, the binding must start with Alt-, should be reasonably universal
# Ctrl- won't work on all keys, see this for a list:
# https://github.com/gdamore/tcell/blob/cb1e5d6fa606/key.go#L83
# An example of a TOML array for multiple keys being bound to one command is the default
# binding for reload:
# bind_reload = ["R","Ctrl-R"]
# One thing to note here is that "R" is capitalization sensitive, so it means shift-r.
# "Ctrl-R" means both ctrl-r and ctrl-shift-R (this is a quirk of what ctrl-r means on
# an ANSI terminal)
# The default binding for opening the bottom bar for entering a URL or link number is:
# bind_bottom = "Space"
# This is how to get the Spacebar as a keybinding, if you try to use " ", it won't work.
# And, finally, an example of a simple, unmodified character is:
# bind_edit = "e"
# This binds the "e" key to the command to edit the current URL.
# The bind_link[1-90] options are for the commands to go to the first 10 links on a page,
# typically these are bound to the number keys:
# bind_link1 = "1"
# bind_link2 = "2"
# bind_link3 = "3"
# bind_link4 = "4"
# bind_link5 = "5"
# bind_link6 = "6"
# bind_link7 = "7"
# bind_link8 = "8"
# bind_link9 = "9"
# bind_link0 = "0"
2020-08-05 13:31:59 -04:00
2021-02-17 15:25:05 -05:00
# All keybindings:
#
# bind_bottom
# bind_edit
# bind_home
# bind_bookmarks
# bind_add_bookmark
# bind_save
# bind_reload
# bind_back
# bind_forward
# bind_moveup
# bind_movedown
# bind_moveleft
# bind_moveright
2021-02-17 15:25:05 -05:00
# bind_pgup
# bind_pgdn
# bind_new_tab
# bind_close_tab
# bind_next_tab
# bind_prev_tab
# bind_quit
# bind_help
# bind_sub: for viewing the subscriptions page
# bind_add_sub
# bind_copy_page_url
# bind_copy_target_url
2021-05-14 18:09:04 -04:00
# bind_beginning: moving to beginning of page (top left)
# bind_end: same but the for the end (bottom left)
# bind_url_handler_open: Open highlighted URL with URL handler (#143)
2021-02-17 15:25:05 -05:00
[url-handlers]
# Allows setting the commands to run for various URL schemes.
# E.g. to open FTP URLs with FileZilla set the following key:
# ftp = ['filezilla']
# You can set any scheme to 'off' or '' to disable handling it, or
2020-09-01 14:55:52 -04:00
# just leave the key unset.
#
# DO NOT use this for setting the HTTP command.
2020-09-01 14:55:52 -04:00
# Use the http setting in the "a-general" section above.
#
# NOTE: These settings are overrided by the ones in the proxies section.
#
# The best way to define a command is using a string array.
# Examples:
# magnet = ['transmission']
# foo = ['custom-browser', '--flag', '--option=2']
# tel = ['/path/with spaces/in it/telephone']
#
# Note the use of single quotes, so that backslashes will not be escaped.
# Using just a string will also work, but it is deprecated, and will degrade if
# you use paths with spaces.
# This is a special key that defines the handler for all URL schemes for which
# no handler is defined.
# It uses the special value 'default', which will try and use the default
# application on your computer for opening this kind of URI.
other = 'default'
[url-prompts]
# Specify whether a confirmation prompt should be shown before following URL schemes.
# The special key 'other' matches all schemes that don't match any other key.
#
# Example: prompt on every non-gemini URL
# other = true
# gemini = false
#
# Example: only prompt on HTTP(S)
# other = false
# http = true
# https = true
2020-12-24 16:52:04 -05:00
# [[mediatype-handlers]] section
# ---------------------------------
#
# Specify what applications will open certain media types.
# By default your default application will be used to open the file when you select "Open".
# You only need to configure this section if you want to override your default application,
# or do special things like streaming.
#
# Note the use of single quotes for commands, so that backslashes will not be escaped.
#
#
# To open jpeg files with the feh command:
2020-12-24 16:52:04 -05:00
#
# [[mediatype-handlers]]
# cmd = ['feh']
2020-12-24 16:52:04 -05:00
# types = ["image/jpeg"]
#
# Each command that you specify must come under its own [[mediatype-handlers]]. You may
# specify as many [[mediatype-handlers]] as you want to setup multiple commands.
#
# If the subtype is omitted then the specified command will be used for the
# entire type:
2020-12-24 16:52:04 -05:00
#
# [[mediatype-handlers]]
# command = ['vlc', '--flag']
2020-12-24 16:52:04 -05:00
# types = ["audio", "video"]
#
# A catch-all handler can by specified with "*".
# Note that there are already catch-all handlers in place for all OSes,
# that open the file using your default application. This is only if you
# want to override that.
2020-12-24 16:52:04 -05:00
#
# [[mediatype-handlers]]
# cmd = ['some-command']
2020-12-24 16:52:04 -05:00
# types = [
# "application/pdf",
# "*",
# ]
#
# You can also choose to stream the data instead of downloading it all before
# opening it. This is especially useful for large video or audio files, as
# well as radio streams, which will never complete. You can do this like so:
#
# [[mediatype-handlers]]
# cmd = ['vlc', '-']
# types = ["audio", "video"]
# stream = true
#
# This uses vlc to stream all video and audio content.
# By default stream is set to off for all handlers
#
#
# If you want to always open a type in its viewer without the download or open
# prompt appearing, you can add no_prompt = true
#
2020-12-24 16:52:04 -05:00
# [[mediatype-handlers]]
# cmd = ['feh']
2020-12-24 16:52:04 -05:00
# types = ["image"]
# no_prompt = true
#
# Note: Multiple handlers cannot be defined for the same full media type, but
# still there needs to be an order for which handlers are used. The following
# order applies regardless of the order written in the config:
#
# 1. Full media type: "image/jpeg"
# 2. Just type: "image"
# 3. Catch-all: "*"
2020-08-06 13:55:43 -04:00
[cache]
2020-12-20 15:54:47 -05:00
# Options for page cache - which is only for text pages
2020-06-18 16:54:48 -04:00
# Increase the cache size to speed up browsing at the expense of memory
# Zero values mean there is no limit
2020-12-20 15:54:47 -05:00
2020-06-18 16:54:48 -04:00
max_size = 0 # Size in bytes
2020-06-20 17:17:34 -04:00
max_pages = 30 # The maximum number of pages the cache will store
2020-07-28 16:58:32 -04:00
2020-12-20 15:54:47 -05:00
# How long a page will stay in cache, in seconds.
timeout = 1800 # 30 mins
2020-08-05 13:31:59 -04:00
2020-09-01 14:55:52 -04:00
[proxies]
# Allows setting a Gemini proxy for different schemes.
# The settings are similar to the url-handlers section above.
# E.g. to open a gopher page by connecting to a Gemini proxy server:
# gopher = "example.com:123"
#
# Port 1965 is assumed if no port is specified.
#
# NOTE: These settings override any external handlers specified in
# the url-handlers section.
#
# Note that HTTP and HTTPS are treated as separate protocols here.
2020-11-27 17:01:29 -05:00
[subscriptions]
2020-11-18 21:24:26 -05:00
# For tracking feeds and pages
# Whether a pop-up appears when viewing a potential feed
popup = true
2020-11-27 17:01:29 -05:00
# How often to check for updates to subscriptions in the background, in seconds.
# Set it to 0 to disable this feature. You can still update individual feeds
# manually, or restart the browser.
#
# Note Amfora will check for updates on browser start no matter what this setting is.
2020-11-18 21:24:26 -05:00
update_interval = 1800 # 30 mins
2020-11-27 17:01:29 -05:00
# How many subscriptions can be checked at the same time when updating.
# If you have many subscriptions you may want to increase this for faster
# update times. Any value below 1 will be corrected to 1.
2020-11-18 21:24:26 -05:00
workers = 3
2020-12-06 20:57:57 -05:00
# The number of subscription updates displayed per page.
entries_per_page = 20
# Set to false to remove the explanatory text from the top of the subscription page
header = true
2020-11-18 21:24:26 -05:00
2020-07-28 16:58:32 -04:00
[theme]
# This section is for changing the COLORS used in Amfora.
2020-08-05 13:31:59 -04:00
# These colors only apply if 'color' is enabled above.
# Colors can be set using a W3C color name, or a hex value such as "#ffffff".
# Setting a background to "default" keeps the terminal default
# If your terminal has transparency, set any background to "default" to keep it transparent
# The key "bg" is already set to "default", but this can be used on other backgrounds,
# like for modals.
2020-07-28 16:58:32 -04:00
# Note that not all colors will work on terminals that do not have truecolor support.
# If you want to stick to the standard 16 or 256 colors, you can get
# a list of those here: https://jonasjacek.github.io/colors/
2020-08-05 13:31:59 -04:00
# DO NOT use the names from that site, just the hex codes.
2020-07-28 16:58:32 -04:00
# Definitions:
# bg = background
# fg = foreground
# dl = download
# btn = button
# hdg = heading
# bkmk = bookmark
# modal = a popup window/box in the middle of the screen
# EXAMPLES:
# hdg_1 = "green"
# hdg_2 = "#5f0000"
# bg = "default"
2020-07-28 16:58:32 -04:00
# Available keys to set:
# bg: background for pages, tab row, app in general
# tab_num: The number/highlight of the tabs at the top
# tab_divider: The color of the divider character between tab numbers: |
# bottombar_label: The color of the prompt that appears when you press space
# bottombar_text: The color of the text you type
# bottombar_bg
# scrollbar: The scrollbar that appears on the right for long pages
2020-07-28 16:58:32 -04:00
2021-12-28 19:43:24 -05:00
# You can also set an 'include' key to process another TOML file that contains theme keys.
# Example:
# include = "my/path/to/special-theme.toml"
#
# Any other theme keys will override this external file.
# You can use this special key to switch between themes easily.
# Download other themes here: https://github.com/makeworld-the-better-one/amfora/tree/master/contrib/themes
2020-07-28 16:58:32 -04:00
# hdg_1
# hdg_2
# hdg_3
# amfora_link: A link that Amfora supports viewing. For now this is only gemini://
# foreign_link: HTTP(S), Gopher, etc
# link_number: The silver number that appears to the left of a link
# regular_text: Normal gemini text, and plaintext documents
# quote_text
# preformatted_text
# list_text
# btn_bg: The bg color for all modal buttons
# btn_text: The text color for all modal buttons
# dl_choice_modal_bg
# dl_choice_modal_text
# dl_modal_bg
# dl_modal_text
# info_modal_bg
# info_modal_text
# error_modal_bg
# error_modal_text
# yesno_modal_bg
# yesno_modal_text
# tofu_modal_bg
# tofu_modal_text
2020-11-27 17:01:29 -05:00
# subscription_modal_bg
# subscription_modal_text
2020-07-28 16:58:32 -04:00
# input_modal_bg
# input_modal_text
# input_modal_field_bg: The bg of the input field, where you type the text
# input_modal_field_text: The color of the text you type
# bkmk_modal_bg
# bkmk_modal_text
# bkmk_modal_label
# bkmk_modal_field_bg
2020-08-27 22:40:40 -04:00
# bkmk_modal_field_text
`)