💾 Archived View for gmn.clttr.info › sources › astro.git › tree › astro.en.1.txt captured on 2023-12-28 at 15:44:09.
-=-=-=-=-=-=-
.TH ASTRO "1" "November 2023" "astro 0.25.0" "User Commands" .SH NAME astro \- A Gemini web browser using shell script .SH SYNOPSIS .B astro [\fI\,URL\/\fR]\fI\,|\/\fR[\fI\,OPTION\/\fR] .SH DESCRIPTION astro v0.25.0: Browse the gemini web on any POSIX compatible terminal. .SH OPTIONS .TP \fB\-h\fR, \fB\-\-help\fR show this help .TP \fB\-v\fR, \fB\-\-version\fR show version info .SH COMMANDS These are the default keybindings to use while running astro: .TP \fBq quit .TP \fBg go to a link .TP \fBr reload current page .TP \fBb go back one page .TP \fBu jump one path segment up .TP \fBo open an address .TP \fBs save current page .TP \fBH go to homepage .TP \fBm add bookmark .TP \fBM go to a bookmark .TP \fBK remove bookmark for current url .SH ENVIRONMENT Astro uses 2 environment variables to help debugging and tracing its execution. .TP \fIdebug To start astro in debug mode .TP \fItrace To start astro with tracing activated .SH NOTES .SS Client certificates .PP \fBastro\fR can work with client certificates if capsules requires them for authentication. \fBastro\fR 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 certificates are stored in \fI$XDG_CONFIG_DIR/astro/certs/\fR. .PP To remove a certificate simply delete the \fI<domain>.crt\fR and \fI<domain>.key\fR files in the directory mentioned above. .SH CONFIGURATION You can setup a config file at \fI$XDG_CONFIG_DIR/astro/astro.conf\fR to configure \fBastro\fR the way you like. The file uses a simple \fBkey=value\fR style, see the complete example for the default values below. .PP .EX margin=8 homepage="gemini.circumlunar.space/" sty_header1='\e033[35;7;1m' sty_header2='\e033[35;4;1m' sty_header3='\e033[35;4m' sty_quote='\e033[2;3m ' sty_linkb='\e033[35m' sty_linkt=' => \e033[36;3m ' sty_listb='\e033[35;1m •' sty_listt='\e033[0m' openkey='o' openlocalkey='O' gokey='g' refreshkey='r' backkey='b' quitkey='q' markkey='b' gomarkkey='M' delmarkkey='K' goupkey='u' homekey='H' .EE .SH EXAMPLES .TP astro Start browsing the default webpage .TP astro url Start browsing url .TP astro \-\-help Show help .SH AUTHOR Written by Brian Lee Mayer. .SH "REPORTING BUGS" Report bugs to: bleemayer@gmail.com .br Home page: <https://www.github.com/blmayer/astro/> .br General help: <https://www.github.com/blmayer/astro/wiki> .SH COPYRIGHT Copyright \(co 2021\-2023 Brian Mayer. License MIT: MIT License <https://opensource.org/licenses/MIT> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. .SH "SEE ALSO" The full documentation for .B astro is maintained as a Texinfo manual. If the .B info and .B astro programs are properly installed at your site, the command .IP .B info astro .PP should give you access to the complete manual.