astro
A Gemini web browser using shell script
Installing
There is an AUR package for archlinux users:
You can also move the file astro to a folder in your PATH variable,
or run make install
, by default it will be installed into ~/.local/bin.
Use PREFIX to override the install location, e.g.
Using
Start browsing by running astro with an optional URL:
astro gemini://rawtext.club:1965/~sloum/spacewalk.gmi
you can omit the protocol and port:
astro rawtext.club/~sloum/spacewalk.gmi
no arguments takes you to gemini.circumlunar.space:
astro
Client certificates
astro can work with client certificates if capsules requires them for authentication.
astro allows a single client certificate per (sub)domain identified by it's name. If a client cert for a specific domain is available astro will send it to the server with every request.
When a resource requires a client cert and astro can't find one it will show you a command to create a client cert for the capsule. The certicates are stored in ~/.config/astro/certs/
.
To remove a certificate simply delete the <domain>.crt
and <domain>.key
files in the directory mentioned above.
Key bindings
b
to go back one pageo
to open a new URL, you'll be prompted to type itr
to reload the pageH
to go to the home pageg
to follow a link in the current page, a link will be displayed, ands
to save the page to a filem
to add the current page to bookmarksM
to go to a bookmarkq
to quit
More coming.
Configuration
You can setup a config file at ~/.config/astro/astro.conf
to configure astro the way you like.
The file uses a simple key=value
style, see the complete example for the default values below.
hints:
astro
will be appended tocachehome
, the directory must be writable for your user.- The
style-
keys must be ANSI style codes.
cachehome=~/.cache/
margin=8
homepage=gemini.circumlunar.space
style-header1=35;4;1
style-header2=35;1
style-header3=35;4
style-quote=2;3
style-link-bullet=33
style-link-text=36;3
style-list-bullet=35;1
style-list-text=0
Meta
This software is a work in progress and may not work as it is intended to.
Contributing
Please read the contributing file.
Further works
- Better history
- Opening files
- Support input
Inspired by
Packaging
I'm not the maintainer of the AUR packages for this project, thanks guzzisti for the contribution.