A fancy terminal browser for the Gemini protocol.
Go to file
2020-06-21 23:56:25 -04:00
cache 🎉 Initial commit, full featured 2020-06-18 16:54:48 -04:00
client Add TOFU continue option - fixes #6 2020-06-21 20:37:27 -04:00
config ️ Replace dir & path funcs with cached strings 2020-06-21 17:35:19 -04:00
display 🐛 bottomBar is not in focus when loading 2020-06-21 23:56:25 -04:00
logger 🎉 Initial commit, full featured 2020-06-18 16:54:48 -04:00
renderer Support all text/* documents - fixes #12 2020-06-21 23:49:43 -04:00
structs Side-scrolling and margin UX greatly improved 2020-06-21 16:53:12 -04:00
webbrowser 🎉 Initial commit, full featured 2020-06-18 16:54:48 -04:00
.gitignore Tidy up 2020-06-18 17:08:32 -04:00
amfora.desktop 🔥 Remove opening multiple URLs on the command line 2020-06-21 19:48:58 -04:00
amfora.go 🔥 Remove opening multiple URLs on the command line 2020-06-21 19:48:58 -04:00
CHANGELOG.md 🐛 bottomBar is not in focus when loading 2020-06-21 23:56:25 -04:00
default-config.toml Side-scrolling and margin UX greatly improved 2020-06-21 16:53:12 -04:00
demo-large.gif 📝 Update README with Gif 2020-06-18 19:10:45 -04:00
go.mod ⬆️ Status 21 is invalid now 2020-06-21 23:39:33 -04:00
go.sum ⬆️ Status 21 is invalid now 2020-06-21 23:39:33 -04:00
LICENSE Create LICENSE 2020-06-18 16:56:57 -04:00
logo.png 🎉 Initial commit, full featured 2020-06-18 16:54:48 -04:00
NOTES.md Add TOFU continue option - fixes #6 2020-06-21 20:37:27 -04:00
README.md ⬆️ Status 21 is invalid now 2020-06-21 23:39:33 -04:00

Amfora

amphora logo
Modified from: amphora by Alvaro Cabrera from the Noun Project

go reportcard license GPLv3

Demo GIF

Amfora aims to be the best looking Gemini client with the most features... all in the terminal. It does not support Gopher or other non-Web protocols - check out Bombadillo for that.

It also aims to be completely cross platform, with full Windows support. If you're on Windows, I would not recommend using the default terminal software. Maybe use Cmder instead?

It fully passes Sean Conman's client torture test, including the new Unicode tests. It mostly passes the Egsam test.

Installation

Download a binary from the releases page. On Unix-based systems you might have to make the binary executable with chmod +x <filename>. On Windows, make sure you click "Advanced > Run anyway" after double-clicking, or something like that.

Unix systems can install the desktop entry file to get Amfora to appear when they search for applications:

curl -sSL https://raw.githubusercontent.com/makeworld-the-better-one/amfora/master/amfora.desktop -o ~/.local/share/applications/amfora.desktop
update-desktop-database ~/.local/share/applications

Usage

Just call amfora or amfora <url> on the terminal. On Windows it might be amfora.exe instead.

The project keeps many standard terminal keybindings and is intuitive. Press ? inside the application to pull up the help menu with a list of all the keybindings, and Esc to leave it. If you have used Bombadillo you will find it similar.

It is designed with large or fullscreen terminals in mind. For optimal usage, make your terminal fullscreen. It was also designed with a dark background terminal in mind, but please file an issue if the colour choices look bad on your terminal setup. It was tested with left-to-right languages, and will likely not work as well with right-to-left languages like Arabic.

Features / Roadmap

Features in italics are in the master branch, but not in the latest release.

  • URL browsing with TOFU and error handling
  • Tabbed browsing
  • Support ANSI color codes on pages, even for Windows
  • Styled page content (headings, links)
  • Basic forward/backward history, for each tab
  • Input (Status Code 10 & 11)
  • Multiple charset support (over 55)
  • Built-in search using GUS
  • Bookmarks
  • Search in pages with Ctrl-F
  • Download pages and arbitrary data
  • Emoji favicons
    • See gemini://mozz.us/files/rfc_gemini_favicon.gmi for details
  • Full mouse support
  • Table of contents for pages
  • Full client certificate UX within the client
  • Subscribe to RSS and Atom feeds and display them
  • Support Markdown rendering
  • History browser

Configuration

The config file is written in the intuitive TOML file format. See default-config.toml for details. By default this file is available at ~/.config/amfora/config.toml.

On Windows, the file is in %APPDATA%\amfora\config.toml, which usually expands to C:\Users\<username>\AppData\Roaming\amfora\config.toml.

Libraries

Amfora ❤️ open source!

  • cview for the TUI
    • It's a fork of tview with PRs merged and active support
    • It uses tcell for low level terminal operations
  • Viper for configuration and TOFU storing
  • go-gemini, my forked and updated Gemini client/server library

License

This project is licensed under the GPL v3.0. See the LICENSE file for details.