gmni(1) General Commands Manual gmni(1)

gmni - Gemini client

gmni [-46lLiIN] [-j mode] [-E path] [-d input] [-D path] gemini://...

gmni executes a gemini request and, if successful, prints the response body to stdout.

If an error is returned, information is printed to stderr and the process exits with a non-zero exit status equal to the response status. If a response is returned which is neither successful or an error, the response status and meta text are printed to stderr.

If the server requests user input, a prompt is shown and a second request is performed with the user's input supplied to the server.

-4

Force the connection to use IPv4.

-6

Force the connection to use IPv6.

-d input

If the server requests user input, a second request is performed with the given input string as the user input.

-D path

If the server requests user input, path is opened and read, and a second request is performed with the contents of path as the user input.

-E path:key

Sets the path to the client certificate and private key file to use, both PEM encoded.

-l

For text/* responses, gmni normally adds a line feed if stdout is a TTY and the response body does not include one. This flag suppresses this behavior.

-L

Follow redirects.

-j mode

Sets the TOFU (trust on first use) configuration, which controls if the client shall trust new certificates. mode can be one of always, once, or fail.

-i

Print the response status and meta text to stdout.

-I

Print the response status and meta text to stdout, and suppress the printing of the response body to stdout.

-N

Suppress the input prompt if the server requests an input, and instead print a diagnostic message and exit with a zero (successful) status code.

-o path

Write output to path. If path ends with a '/', the basename of the URL will be appended. If path is the empty string, "./" will be presumed.
2023-05-29