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. Use Windows Terminal instead, and make sure it works with UTF-8. Note that some of the application colors might not display correctly on Windows, but all functionality will still work.
It fully passes Sean Conman's client torture test, as well as the Egsam one.
Amfora is in maintenance mode. When possible, I’ll make/merge bug fixes, and maybe slowly merge feature PRs by others. See my blog post for details.
Download a binary from the releases page. On Unix-based systems you will have to make the file executable with chmod +x <filename>
. You can rename the file to just amfora
for easy access, and move it to /usr/local/bin/
.
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
Make sure to click "Watch" in the top right, then "Custom" > "Releases" to get notified about new releases!
Amfora is packaged in many Linux distros. It's also on Scoop for Windows users.
If you use Homebrew, you can install Amfora with:
brew install amfora
You can update it with:
brew upgrade amfora
On macOS, Amfora can also be installed through MacPorts:
sudo port install amfora
You can update it with:
sudo port selfupdate
sudo port upgrade amfora
NOTE: this installation source is community-maintained. More information here.
If you're using Termux on Android you can't just run Amfora like normal. After installing Amfora, run pkg install proot
. Then run termux-chroot
before running the Amfora binary. You can exit out of the chroot after closing Amfora. See here for why this is needed.
This section is for advanced users who want to install the latest (possibly unstable) version of Amfora.
Features in italics are in the master branch, but not in the latest release.
Please see the wiki for an introduction on how to use Amfora and configure it.
Amfora ❤️ open source!
This project is licensed under the GPL v3.0. See the LICENSE file for details.