AMFORA(1)

NAME
amfora - fancy terminal gemini browser

SYNOPSIS
amfora [-h | -v | gemini-url]

DESCRIPTION
amfora is a fancy gemini client in your terminal, written in Go; supporting tabs, caching, theming, proxying, subscriptions, client certificates, external link handling, syntax highlighting, and a built in search engine. Subscriptions are supported through gemini, atom, RSS, and JSON Feed files.

  DEFAULT KEY BINDINGS
The following key bindings update in the help menu upon config change:

?   Open help menu
0-9 Access link 1-10 on page
Ctrl-A
    Visit subscription feed
Ctrl-C
    Hard quit
Ctrl-S
    Save loaded page to disk
Ctrl-T
    Open highlighted link in new tab
Ctrl-X
    Subscribe to current page
F1  Previous tab
F2  Next tab
Esc Close menu/bar
Space
    Open bottom bar
Tab or Enter
    Begin link highlighting
Tab Highlight next link
Shift-Tab
    Highlight previous link
Shift-q
    Exit

  BOTTOM BAR COMMANDS
about:about
    About meta page
about:manage-subscriptions
    Unsubscribe list
about:subscriptions
    Subscription feed
about:version
    Version info
foo Search the geminispace for foo.
new:N
    Visit link N

  CONFIGURATION
A well-commented default configuration file, written in TOML, is generated on first use if it doesn't already exist.

In the configuration directory you can also create a gemtext file called newtab.gmi to customize your new tab page.

  BOOKMARKS
amfora stores its bookmarks in an XML format called XBEL, located at ~/.local/share/amfora/bookmarks.xml by default. If the XDG_DATA_HOME variable is set then the configuration file can be found at XDG_DATA_HOME/amfora/bookmarks.xml.

On Windows, the file can be found at %APPDATA%\amfora\bookmarks.xml, which usually expands to C:\Users\<username>\AppData\Roaming\amfora\bookmarks.xml.

See EXAMPLE BOOKMARK

FILES

  *NIX
~/.config/amfora/config.toml
~/.local/share/amfora/bookmarks.xml

  XDG
$XDG_CONFIG_HOME/amfora/config.toml
$XDG_DATA_HOME/amfora/bookmarks.xml

  WINDOWS
%APPDATA%\amfora\config.toml
%APPDATA%\amfora\bookmarks.xml

EXIT STATUS
amfora exits 0 on success, and 1 if an error occurs.

EXAMPLES

  EXAMPLE BOOKMARK

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE xbel
      PUBLIC "+//IDN python.org//DTD XML Bookmark Exchange Language 1.1//EN//XML"
             "http://www.python.org/topics/xml/dtds/xbel-1.1.dtd">
    <xbel version="1.1">
        <bookmark href="gemini://example.com/">
            <title>Example Bookmark</title>
        </bookmark>
    </xbel>

  EXAMPLE PROXY

    [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

  EXAMPLE CERTIFICATE

    [auth]
    # Authentication settings
    [auth.certs]
    # Client certificates
    # Set domain name equal to path to client cert
    # "example.com" = "mycert.crt"
    "astrobotany.mozz.us" = "~/.local/share/amfora/astrobotany-cert.pem"
    [auth.keys]
    # Client certificate keys
    # Set domain name equal to path to key for the client cert above
    # "example.com" = "mycert.key"
    "astrobotany.mozz.us" = "~/.local/share/amfora/astrobotany-key.pem"

DIAGNOSTICS
Errors are printed to stderr.

SEE ALSO
The official documentation is maintained in two places:
gemini://makeworld.space/amfora-wiki/
https://github.com/makeworld-the-better-one/amfora/wiki

agena.py gemini-to-gopher proxy.
bombadillo: https://bombadillo.colorfield.space/
duckling-proxy.go gemini-to-HTTPS proxy.

STANDARDS
https://geminiprotocol.net/docs/tech-overview.gmi
    Gemini Technical Overview
https://toml.io/en/
    Configuration syntax
http://pyxml.sourceforge.net/topics/xbel/docs/html/xbel.html
    Bookmark syntax
https://www.iana.org/assignments/media-types/media-types.xhtml
    Media Types

HISTORY
The amfora utility was originally written by makeworld <makeworld@protonmail.com> for Linux in 2020.

CAVEATS
Using OpenSSL on Windows is not so easy. One way is to install Chocolatey, and run ‘choco install openssl’

amfora does not support gopher or other non-web protocols - check out bombadillo: https://bombadillo.colorfield.space/ for that.

BUGS
There are sometimes known UI rendering glitches.