mirror of
https://github.com/makeworld-the-better-one/amfora.git
synced 2024-11-26 10:15:13 +03:00
192 lines
7.2 KiB
Markdown
192 lines
7.2 KiB
Markdown
# Amfora
|
|
|
|
<center> <!-- I know, that's not how you usually do it :) -->
|
|
<img src="logo.png" alt="amphora logo" width="30%">
|
|
<h6>Image modified from: amphora by Alvaro Cabrera from the Noun Project</h6>
|
|
</center>
|
|
|
|
[](https://goreportcard.com/report/github.com/makeworld-the-better-one/amfora)
|
|
[](https://www.gnu.org/licenses/gpl-3.0.en.html)
|
|
|
|
<center> <!-- I know, that's not how you usually do it :) -->
|
|
<a href="https://raw.githubusercontent.com/makeworld-the-better-one/amfora/master/demo-large.gif">
|
|
<img src="demo-large.gif" alt="Demo GIF" width="80%">
|
|
</a>
|
|
</center>
|
|
|
|
###### Recording of v1.0.0
|
|
|
|
Amfora aims to be the best looking [Gemini](https://gemini.circumlunar.space/) client with the most features... all in the terminal. It does not support Gopher or other non-Web protocols - check out [Bombadillo](http://bombadillo.colorfield.space/) 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](https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701) instead, and make sure it [works with UTF-8](https://akr.am/blog/posts/using-utf-8-in-the-windows-terminal). 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.
|
|
|
|
## Installation
|
|
|
|
### Binary
|
|
|
|
Download a binary from the [releases](https://github.com/makeworld-the-better-one/amfora/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:
|
|
```bash
|
|
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!
|
|
|
|
|
|
### Arch Linux
|
|
|
|
Arch Linux users can install Amfora using pacman.
|
|
|
|
```
|
|
sudo pacman -S amfora
|
|
```
|
|
|
|
### Void Linux
|
|
|
|
Void Linux users can install Amfora using xbps.
|
|
|
|
```
|
|
sudo xbps-install amfora
|
|
```
|
|
|
|
### Homebrew
|
|
|
|
If you use [Homebrew](https://brew.sh/), you can install Amfora through the my personal tap.
|
|
```
|
|
brew tap makeworld-the-better-one/tap
|
|
brew install amfora
|
|
```
|
|
You can update it with:
|
|
```
|
|
brew upgrade amfora
|
|
```
|
|
|
|
### KISS Linux
|
|
|
|
[KISS](https://k1ss.org) Linux users can install Amfora from jedahan's repository.
|
|
|
|
Add jedahan's kiss repository:
|
|
```
|
|
git clone https://github.com/jedahan/kiss-repo.git repo-jedahan
|
|
export KISS_PATH="$KISS_PATH:$PWD/repo-jedahan"
|
|
```
|
|
|
|
Build and install Amfora:
|
|
```
|
|
kiss build amfora
|
|
kiss install amfora
|
|
```
|
|
|
|
### From Source
|
|
|
|
This section is for advanced users who want to install the latest (possibly unstable) version of Amfora.
|
|
|
|
<details>
|
|
<summary>Click to expand</summary>
|
|
|
|
**Requirements:**
|
|
- Go 1.13 or later
|
|
- GNU Make
|
|
|
|
Please note the Makefile does not intend to support Windows, and so there may be issues.
|
|
|
|
```shell
|
|
git clone https://github.com/makeworld-the-better-one/amfora
|
|
cd amfora
|
|
# git checkout v1.2.3 # Optionally pin to a specific version instead of the latest commit
|
|
make # Might be gmake on macOS
|
|
sudo make install # If you want to install the binary for all users
|
|
```
|
|
|
|
Because you installed with the Makefile, running `amfora -v` will tell you exactly what commit the binary was built from.
|
|
|
|
Arch Linux users can also install the latest commit of Amfora from the AUR. It has the package name `amfora-git`, and is maintained by @lovetocode999
|
|
|
|
```
|
|
yay -S amfora-git
|
|
```
|
|
|
|
MacOS users can also use [Homebrew](https://brew.sh/) to install the latest commit of Amfora:
|
|
|
|
```
|
|
brew tap makeworld-the-better-one/tap
|
|
brew install --HEAD amfora
|
|
```
|
|
You can update it with:
|
|
```
|
|
brew upgrade --fetch-HEAD amfora
|
|
```
|
|
|
|
</details>
|
|
|
|
|
|
## Features / Roadmap
|
|
Features in *italics* are in the master branch, but not in the latest release.
|
|
|
|
- [x] URL browsing with TOFU and error handling
|
|
- [x] Tabbed browsing
|
|
- [x] Support ANSI color codes on pages, even for Windows
|
|
- [x] Styled page content (headings, links)
|
|
- [x] Basic forward/backward history, for each tab
|
|
- [x] Input (Status Code 10 & 11)
|
|
- [x] Multiple charset support (over 55)
|
|
- [x] Built-in search (uses GUS by default)
|
|
- [x] Bookmarks
|
|
- [x] Download pages and arbitrary data
|
|
- [x] Theming
|
|
- Check out the [user contributed themes](https://github.com/makeworld-the-better-one/amfora/tree/master/contrib/themes)!
|
|
- [x] Emoji favicons
|
|
- See `gemini://mozz.us/files/rfc_gemini_favicon.gmi` for details
|
|
- Disabled by default, enable in config
|
|
- [x] Proxying
|
|
- Schemes like Gopher or HTTP can be proxied through a Gemini server
|
|
- [x] Client certificate support
|
|
- [ ] Full client certificate UX within the client
|
|
- Create transient and permanent certs within the client, per domain
|
|
- Manage and browse them
|
|
- Similar to [Kristall](https://github.com/MasterQ32/kristall)
|
|
- https://lists.orbitalfox.eu/archives/gemini/2020/001400.html
|
|
- [x] Subscriptions
|
|
- Subscribing to RSS, Atom, and [JSON Feeds](https://jsonfeed.org/) are all supported
|
|
- So is subscribing to a page, to know when it changes
|
|
- [x] *Open non-text files in another application*
|
|
- [x] *Ability to stream content instead of downloading it first*
|
|
- [ ] Stream support
|
|
- [ ] Table of contents for pages
|
|
- [ ] Search in pages with <kbd>Ctrl-F</kbd>
|
|
- [ ] Support Markdown rendering
|
|
- [ ] Persistent history
|
|
|
|
|
|
## Usage & Configuration
|
|
Please see [the wiki](https://github.com/makeworld-the-better-one/amfora/wiki) for an introduction on how to use Amfora and configure it.
|
|
|
|
|
|
## Known Bugs
|
|
|
|
- Pasting on Windows is truncated, the full paste content won't be added. ([#43](https://github.com/makeworld-the-better-one/amfora/issues/43))
|
|
|
|
You can also check out [all the issues with the bug label](https://github.com/makeworld-the-better-one/amfora/issues?q=is%3Aopen+is%3Aissue+label%3Abug).
|
|
|
|
|
|
## Libraries
|
|
Amfora ❤️ open source!
|
|
|
|
- [cview](https://gitlab.com/tslocum/cview/) for the TUI
|
|
- It's a fork of [tview](https://github.com/rivo/tview) with PRs merged and active support
|
|
- It uses [tcell](https://github.com/gdamore/tcell) for low level terminal operations
|
|
- [Viper](https://github.com/spf13/viper) for configuration and TOFU storing
|
|
- [go-gemini](https://github.com/makeworld-the-better-one/go-gemini), my forked and updated Gemini client/server library
|
|
- My [progressbar fork](https://github.com/makeworld-the-better-one/progressbar) - pull request [here](https://github.com/schollz/progressbar/pull/69)
|
|
- [go-humanize](https://github.com/dustin/go-humanize)
|
|
- My [gofeed fork](https://github.com/makeworld-the-better-one/gofeed) - pull request [here](https://github.com/mmcdole/gofeed/pull/164)
|
|
|
|
## License
|
|
This project is licensed under the GPL v3.0. See the [LICENSE](./LICENSE) file for details.
|