AMFORA(1) User Commands 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.

illumos April 16, 2022 illumos