# This is the default config file. # It also shows all the default values, if you don't create the file. # 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 [a-general] # Press Ctrl-H to access it home = "gemini://gemini.circumlunar.space" # 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 # 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. # If a command is set, than the URL will be added (in quotes) to the end of the command. # A space will be prepended to the URL. # # The best to define a command is using a string array. # Examples: # http = ['firefox'] # http = ['custom-browser', '--flag', '--option=2'] # http = ['/path/with spaces/in it/firefox'] # # 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. http = 'firefox --new-tab' # Any URL that will accept a query string can be put here search = "gemini://gus.guru/search" # Whether colors will be used in the terminal color = true # Whether ANSI color codes from the page content should be rendered ansi = true # Whether to replace list asterisks with unicode bullets bullets = true # Whether to show link after link text show_link = true # A number from 0 to 1, indicating what percentage of the terminal width the left margin should take up. left_margin = 0.1 # The max number of columns to wrap a page's text to. Preformatted blocks are not wrapped. max_width = 100 # 'downloads' is the path to a downloads folder. # An empty value means the code will find the default downloads folder for your system. # If the path does not exist it will be created. # Note the use of single quotes, so that backslashes will not be escaped. downloads = '' # 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 # Whether to replace tab numbers with emoji favicons, which are cached. emoji_favicons = false [auth] # Authentication settings # Note the use of single quotes for values, so that backslashes will not be escaped. [auth.certs] # Client certificates # Set domain name equal to path to client cert # "example.com" = 'mycert.crt' [auth.keys] # Client certificate keys # Set domain name equal to path to key for the client cert above # "example.com" = 'mycert.key' [keybindings] # In the future there will be more settings here. # Hold down shift and press the numbers on your keyboard (1,2,3,4,5,6,7,8,9,0) to set this up. # It is default set to be accurate for US keyboards. shift_numbers = "!@#$%^&*()" [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 # just leave the key unset. # # DO NOT use this for setting the HTTP command. # Use the http setting in the "a-general" section above. # # NOTE: These settings are overrided by the ones in the proxies section. # Note the use of single quotes, so that backslashes will not be escaped. # This is a special key that defines the handler for all URL schemes for which # no handler is defined. other = 'off' # [[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: # # [[mediatype-handlers]] # cmd = ['feh'] # 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: # # [[mediatype-handlers]] # command = ['vlc', '--flag'] # 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. # # [[mediatype-handlers]] # cmd = ['some-command'] # 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 # # [[mediatype-handlers]] # cmd = ['feh'] # 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: "*" [cache] # Options for page cache - which is only for text pages # Increase the cache size to speed up browsing at the expense of memory # Zero values mean there is no limit max_size = 0 # Size in bytes max_pages = 30 # The maximum number of pages the cache will store # How long a page will stay in cache, in seconds. timeout = 1800 # 30 mins [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. [subscriptions] # For tracking feeds and pages # Whether a pop-up appears when viewing a potential feed popup = true # 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. update_interval = 1800 # 30 mins # 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. workers = 3 # The number of subscription updates displayed per page. entries_per_page = 20 [theme] # This section is for changing the COLORS used in Amfora. # 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". # 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/ # DO NOT use the names from that site, just the hex codes. # 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" # 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 # 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 # subscription_modal_bg # subscription_modal_text # 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 # bkmk_modal_field_text # _____ __ _________ # ___ | / /__________________ / # __ |/ /_ __ \_ ___/ __ / # _ /| / / /_/ / / / /_/ / # /_/ |_/ \____//_/ \__,_/ # bg = "#2e3440" tab_num = "#88c0d0" tab_divider = "#4c566a" bottombar_label = "#88c0d0" bottombar_text = "#eceff4" bottombar_bg = "#3b4252" hdg_1 = "#5e81ac" hdg_2 = "#81a1c1" hdg_3 = "#8fbcbb" amfora_link = "#88c0d0" foreign_link = "#b48ead" link_number = "#a3be8c" regular_text = "#eceff4" quote_text = "#81a1c1" preformatted_text = "#8fbcbb" list_text = "#d8dee9" btn_bg = "#4c566a" btn_text = "#eceff4" dl_choice_modal_bg = "#3b4252" dl_choice_modal_text = "#eceff4" dl_modal_bg = "#3b4252" dl_modal_text = "#eceff4" info_modal_bg = "#3b4252" info_modal_text = "#eceff4" error_modal_bg = "#bf616a" error_modal_text = "#eceff4" yesno_modal_bg = "#3b4252" yesno_modal_text = "#eceff4" tofu_modal_bg = "#3b4252" tofu_modal_text = "#eceff4" subscription_modal_bg = "#3b4252" subscription_modal_text = "#eceff4" input_modal_bg = "#3b4252" input_modal_text = "#eceff4" input_modal_field_bg = "#4c566a" input_modal_field_text = "#eceff4" bkmk_modal_bg = "#3b4252" bkmk_modal_text = "#eceff4" bkmk_modal_label = "#eceff4" bkmk_modal_field_bg = "#4c566a" bkmk_modal_field_text = "#eceff4" # _______ ________ ______ # __ __ \______________ __ \_____ __________ /__ # _ / / /_ __ \ _ \_ / / / __ `/_ ___/_ //_/ # / /_/ /_ / / / __/ /_/ // /_/ /_ / _ ,< # \____/ /_/ /_/\___//_____/ \__,_/ /_/ /_/|_| # # bg = "#282c34" # fg = "#abb2bf" # tab_num = "#abb2bf" # tab_divider = "#abb2bf" # bottombar_bg = "#abb2bf" # bottombar_text = "#282c34" # bottombar_label = "#282c34" # hdg_1 = "#e06c75" # hdg_2 = "#c678dd" # hdg_3 = "#c678dd" # amfora_link = "#61afef" # foreign_link = "#56b6c2" # link_number = "#abb2bf" # regular_text = "#abb2bf" # quote_text = "#98c379" # preformatted_text = "#e5c07b" # list_text = "#abb2bf" # btn_bg = "#282c34" # btn_text = "#abb2bf" # dl_choice_modal_bg = "#98c379" # dl_choice_modal_text = "#282c34" # dl_modal_bg = "#98c379" # dl_modal_text = "#282c34" # info_modal_bg = "#98c379" # info_modal_text = "#282c34" # error_modal_bg = "#e06c75" # error_modal_text = "#282c34" # yesno_modal_bg = "#e5c07b" # yesno_modal_text = "#282c34" # tofu_modal_bg = "#e5c07b" # tofu_modal_text = "#282c34" # input_modal_bg = "#98c379" # input_modal_text = "#282c34" # input_modal_field_bg = "#282c34" # input_modal_field_text = "#abb2bf" # bkmk_modal_bg = "#98c379" # bkmk_modal_text = "#282c34" # bkmk_modal_label = "#282c34" # bkmk_modal_field_bg = "#282c34" # bkmk_modal_field_text = "#abb2bf" # subscription_modal_bg = "#c678dd" # subscription_modal_text = "#282c34"