💾 Archived View for laniakea.rodoste.de › tui › amfora.gmi captured on 2023-12-28 at 15:27:37. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

amfora: gemini browser

2023-05-26

Amfora is a rather pretty terminal client for the gemini web.

It handles certificates well although you do have to create them manually for now.

It is capable of managing atom/rss feed subscriptions and has a neat timeline view for posts on your subscribed feeds.

keyboard shortcut

| key seq.  | description                                                     |
| --------- | --------------------------------------------------------------- |
| ?         | opens up the keyboard shortcut help                             |
| q         | closes amfora                                                   |
| ctrl-b    | opens the bookmark list                                         |
| ctrl-d    | add / rename / delete bookmark for current page                 |
| ctrl-a    | opens the subscription list                                     |
| ctrl-x    | add or update a subscription                                    |
| ctrl-t    | opens a new tab                                                 |
| F1/F2     | go to next / previous tab                                       |
| ctrl-w    | close the current tab (will only work when on last tab)         |

basic navigation

| key seq.  | description                                                     |
| --------- | --------------------------------------------------------------- |
| hjkl      | navigate with vim keys                                          |
| 0-1       | open the link marked with the number                            |
| <space>-n | opens the link with the number - necessary for links after 9    |
| <space>   | allows to enter an URL                                          |
| b         | go to previous page in browser history                          |
| f         | go to next page in browser history                              |
| ctrl-r    | reload current page                                             |

customization

Amfora has a config.toml file in ~/.config/amfora which is very well documented. You can customize every keybinding etc. Which is useful since some of the default ones conflict with tmux.

Overall through I haven't felt the need to customize amfora much.

proxies

I recently learned that Adicus implemented stargate, a true HTTP to gemini proxy. It allows (some) HTML websites to be displayed in gemini browsers. Now it made sense for me to configure some proxies in amfora:

[proxies]
http = "stargate.gemi.dev:1994"
https = "stargate.gemi.dev:1994"

I don't believe stargate is public yet, but I'll try to set up a docker container for it once it is. Either way, credit where credit is due: Adicus did a fantastic job:

Adicus' announcement of stargate

themes

Okay, I caved. I tokyonight'ed amfora:

[theme]
bottombar_label = "#787c99"
bottombar_text = "#acb0d0"
bottombar_bg = "#43455b"

btn_text = "#32344a"

dl_choice_modal_bg = "#449dab"
dl_choice_modal_text = "#444b6a"
dl_modal_bg = "#449dab"
dl_modal_text = "#444b6a"
info_modal_bg = "#449dab"
info_modal_text = "#444b6a"
error_modal_bg = "#449dab"
error_modal_text = "#444b6a"
yesno_modal_bg = "#449dab"
yesno_modal_text = "#444b6a"
tofu_modal_bg = "#449dab"
tofu_modal_text = "#444b6a"
subscription_modal_bg = "#449dab"
subscription_modal_text = "#444b6a"
bkmk_modal_bg = "#449dab"
bkmk_modal_label = "#32344a"
bkmk_modal_text = "#444b6a"

input_modal_bg = "#449dab"
input_modal_text = "#444b6a"
input_modal_field_text = "#444b6a"

---

see all articles on command-line tools