AMFORA(1) User Commands AMFORA(1)
amfora - fancy terminal gemini browser
amfora [-h | -v | gemini-url]
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.
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
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
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.
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
*NIX
~/.config/amfora/config.toml
~/.local/share/amfora/bookmarks.xml
$XDG_CONFIG_HOME/amfora/config.toml
$XDG_DATA_HOME/amfora/bookmarks.xml
%APPDATA%\amfora\config.toml
%APPDATA%\amfora\bookmarks.xml
amfora exits 0 on success, and 1 if an error occurs.
<?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>
[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
[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"
Errors are printed to stderr.
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.
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
The amfora utility was originally written by makeworld
<makeworld@protonmail.com> for Linux in 2020.
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.
There are sometimes known UI rendering glitches.
illumos April 16, 2022 illumos
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