{"id":13500155,"url":"https://github.com/makew0rld/amfora","last_synced_at":"2025-12-11T23:10:20.880Z","repository":{"id":40676091,"uuid":"273337347","full_name":"makew0rld/amfora","owner":"makew0rld","description":"A fancy terminal browser for the Gemini protocol.","archived":false,"fork":false,"pushed_at":"2024-08-16T23:21:54.000Z","size":2969,"stargazers_count":1162,"open_issues_count":47,"forks_count":67,"subscribers_count":15,"default_branch":"master","last_synced_at":"2024-10-29T15:34:36.751Z","etag":null,"topics":["browser","gemini","gemini-protocol","go","golang","terminal","tui"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/makew0rld.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"makew0rld","ko_fi":"makeworld"}},"created_at":"2020-06-18T20:49:56.000Z","updated_at":"2024-10-26T09:10:44.000Z","dependencies_parsed_at":"2023-09-28T03:29:57.500Z","dependency_job_id":"9b120254-e595-4ea4-8c7b-4cda1e6e8829","html_url":"https://github.com/makew0rld/amfora","commit_stats":{"total_commits":515,"total_committers":57,"mean_commits":9.035087719298245,"dds":"0.20194174757281558","last_synced_commit":"b4aa0bcb72a5db359a1fc0317adbaaa2b41c85e9"},"previous_names":["makeworld-the-better-one/amfora"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makew0rld%2Famfora","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makew0rld%2Famfora/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makew0rld%2Famfora/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makew0rld%2Famfora/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/makew0rld","download_url":"https://codeload.github.com/makew0rld/amfora/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248441660,"owners_count":21104041,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser","gemini","gemini-protocol","go","golang","terminal","tui"],"created_at":"2024-07-31T22:00:51.897Z","updated_at":"2025-12-11T23:10:20.847Z","avatar_url":"https://github.com/makew0rld.png","language":"Go","funding_links":["https://github.com/sponsors/makew0rld","https://ko-fi.com/makeworld"],"categories":["ATOM/RSS Feeds","Go","\u003ca name=\"browser\"\u003e\u003c/a\u003eWeb browser","Internet 🌐"],"sub_categories":["Readers","Gemini (Clients / Servers)"],"readme":"# Amfora\n\n\u003cimg src=\"logo.png\" alt=\"amphora logo\" width=\"30%\"\u003e\n\u003ch6\u003eImage modified from: amphora by Alvaro Cabrera from the Noun Project\u003c/h6\u003e\n\n\n[![go reportcard](https://goreportcard.com/badge/github.com/makeworld-the-better-one/amfora)](https://goreportcard.com/report/github.com/makeworld-the-better-one/amfora)\n[![license GPLv3](https://img.shields.io/github/license/makeworld-the-better-one/amfora)](https://www.gnu.org/licenses/gpl-3.0.en.html)\n\n\u003ca href=\"https://raw.githubusercontent.com/makeworld-the-better-one/amfora/master/demo-large.gif\"\u003e\n\u003cimg src=\"demo-large.gif\" alt=\"Demo GIF\" width=\"80%\"\u003e\n\u003c/a\u003e\n\n###### Recording of v1.0.0\n\nAmfora aims to be the best looking [Gemini](https://geminiquickst.art/) 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.\n\nIt 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.\n\nIt fully passes Sean Conman's client torture test, as well as the Egsam one.\n\n## Project Status\n\nAmfora is in maintenance mode. When possible, I’ll make/merge bug fixes, and maybe slowly merge feature PRs by others. See my [blog post](https://www.makeworld.space/2023/08/bye_gemini.html) for details.\n\n## Installation\n\n### Binary\n\nDownload 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 \u003cfilename\u003e`. You can rename the file to just `amfora` for easy access, and move it to `/usr/local/bin/`.\n\nOn Windows, make sure you click \"Advanced \u003e Run anyway\" after double-clicking, or something like that.\n\nUnix systems can install the desktop entry file to get Amfora to appear when they search for applications:\n```bash\ncurl -sSL https://raw.githubusercontent.com/makeworld-the-better-one/amfora/master/amfora.desktop -o ~/.local/share/applications/amfora.desktop\nupdate-desktop-database ~/.local/share/applications\n```\n\nMake sure to click \"Watch\" in the top right, then \"Custom\" \u003e \"Releases\" to get notified about new releases!\n\n\n### Linux\n\n\u003ca href=\"https://repology.org/project/amfora/versions\"\u003e\n    \u003cimg src=\"https://repology.org/badge/vertical-allrepos/amfora.svg\" alt=\"Packaging status\" align=\"right\"\u003e\n\u003c/a\u003e\n\nAmfora is packaged in many Linux distros. It's also on [Scoop](https://scoop.sh/) for Windows users.\n\n### macOS (Homebrew)\n\nIf you use [Homebrew](https://brew.sh/), you can install Amfora with:\n```\nbrew install amfora\n```\nYou can update it with:\n```\nbrew upgrade amfora\n```\n\n### macOS (MacPorts)\n\nOn macOS, Amfora can also be installed through [MacPorts](https://www.macports.org):\n```\nsudo port install amfora\n```\nYou can update it with:\n```\nsudo port selfupdate\nsudo port upgrade amfora\n```\n**NOTE:** this installation source is community-maintained. More information [here](https://ports.macports.org/port/amfora/).\n\n### Termux\n\nIf you're using [Termux](https://termux.com/) 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](https://stackoverflow.com/q/38959067/7361270) for why this is needed.\n\n### From Source\n\nThis section is for advanced users who want to install the latest (possibly unstable) version of Amfora.\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to expand\u003c/summary\u003e\n\n**Requirements:**\n- Go 1.15 or later\n- GNU Make\n\nPlease note the Makefile does not intend to support Windows, and so there may be issues.\n\n```shell\ngit clone https://github.com/makeworld-the-better-one/amfora\ncd amfora\n# git checkout v1.2.3 # Optionally pin to a specific version instead of the latest commit\nmake # Might be gmake on macOS\nsudo make install # If you want to install the binary for all users\n```\n\nBecause you installed with the Makefile, running `amfora -v` will tell you exactly what commit the binary was built from.\n\nArch 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\n\n```\nyay -S amfora-git\n```\n\nMacOS users can also use [Homebrew](https://brew.sh/) to install the latest commit of Amfora:\n\n```\nbrew install --HEAD amfora\n```\nYou can update it with:\n```\nbrew upgrade --fetch-HEAD amfora\n```\n\n\u003c/details\u003e\n\n\n## Features\nFeatures in *italics* are in the master branch, but not in the latest release.\n\n- URL browsing with TOFU and error handling\n- Tabbed browsing\n- Support ANSI color codes on pages, even for Windows\n- Styled page content (headings, links)\n- Basic forward/backward history, for each tab\n- Input (Status Code 10 \u0026 11)\n- Multiple charset support (over 55)\n- Built-in search (uses geminispace.info by default)\n- Bookmarks\n- Download pages and arbitrary data\n- Theming\n  - Check out the [user contributed themes](https://github.com/makeworld-the-better-one/amfora/tree/master/contrib/themes)!\n- Proxying\n  - Schemes like Gopher or HTTP can be proxied through a Gemini server\n- Client certificate support\n- Subscriptions\n  - Subscribing to RSS, Atom, and [JSON Feeds](https://jsonfeed.org/) are all supported\n  - So is subscribing to a page, to know when it changes\n- Open non-text files in another application\n  - Ability to stream content instead of downloading it first\n- Highlighting of preformatted code blocks that list a language in the alt text\n- *Search in pages with \u003ckbd\u003eCtrl-F\u003c/kbd\u003e*\n- *Run custom commands using the current or selected URL as an argument*\n\n\n## Usage \u0026 Configuration\nPlease see [the wiki](https://github.com/makeworld-the-better-one/amfora/wiki) for an introduction on how to use Amfora and configure it.\n\n## Libraries\nAmfora ❤️ open source!\n\n- [cview](https://code.rocketnine.space/tslocum/cview) for the TUI\n  - It's a fork of [tview](https://github.com/rivo/tview) with PRs merged and active support\n  - It uses [tcell](https://github.com/gdamore/tcell) for low level terminal operations\n- [Viper](https://github.com/spf13/viper) for configuration and TOFU storing\n- [go-gemini](https://github.com/makeworld-the-better-one/go-gemini), my forked and updated Gemini client/server library\n- [progressbar](https://github.com/schollz/progressbar)\n- [go-humanize](https://github.com/dustin/go-humanize)\n- [gofeed](https://github.com/mmcdole/gofeed)\n- [chroma](https://github.com/alecthomas/chroma) for source code syntax highlighting\n- [clipboard](https://github.com/atotto/clipboard)\n- [termenv](https://github.com/muesli/termenv)\n\n## License\nThis project is licensed under the GPL v3.0. See the [LICENSE](./LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakew0rld%2Famfora","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmakew0rld%2Famfora","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakew0rld%2Famfora/lists"}