Better config option name for clipboard
Add clipboard command, better help message styles, refactor
Display: Use Style colors
A minimalist line-mode gemini client written in go.
WARNING: the project is still in its early stages so do expect bugs and incomplete features, if you encounter them or would like to suggest an improvement, feel free to submit to the ticket tracker on srht or the one on github.
You get a simple line-mode interface to navigate URLs, plus a pager to view pages. Seriously, what more do you want?
I plan to set up automated uploads of pre-built binaries to each release at some point in the future. As of now the only option is to build from source.
First, install the dependencies:
Clone the repo somewhere reasonable:
git clone https://git.sr.ht/~hedy/gelim cd gelim # git checkout v0.0.0 # pin specific version or commit
Build, optionally set
PREFIX (default is
If all goes well, install gelim:
Remember to use the same
Optionally verify your installation:
The gelim binary would be sitting at
$PREFIX/bin/ with manpage at
io.ReadAll: Upgrade your go version to something higher or equal to v1.16 and then try again.
If you're having other issues with installation, please send an email to the mailing list with errors/logs if available.
If you used the Makefile to install gelim the manpage should automatically be built and installed. See gelim(1)
I'm also planning to have a mirror of that manual hosted on man.sr.ht in the future if easy access.
Note that the manpage may not be the most recently updated. But new features and things like that will definitely be put in there once it's tested stable.
This will bring you to less(1). You can use less to browse the page normally.
Note: if you see something like "-P is not an option", don't panic, this is because your system does not support one of gelim's default less options, you should skip over to the 'config' section below, and configure your lessOpts to remove the mouse option, and any other your version of less doesn't have.
When you want to visit a link, you have to quit less first. Press
The page will be fetched and you'll be in less again.
Now let's try something more interesting.
While you're at the prompt type:
Say you don't have an account on RTC yet and would like to sign up.
Go to the bottom of the page, where the link to signing up is provided. Type
Then, you have to quit the pager. Press
Look for the link number that links to the sign up page, and enter it directly at the prompt. As of writing, the link number is 38, but keep in mind this number may change when you are trying this out.
And now you've decided to have a look at rawtext.club's values at the front page on more time. Unfortunately, the sign up page does not provide a link to go back to home. No worries, you can directly use the path (prefixed with . or /) at the prompt.
Let's try it out. Quit the pager (
q), and type
/ and press enter
Voila, you're at the front page again!
Thanks for trying out this quickstart tutorial, there is still much to explore. Type in
from the prompt and check out the commands, have fun!
For people on a Unix system it will look for configuration in
Though you do not need a configuration file to have gelim working.
# example config prompt = "-->" # default: "%U" (the full url of # the current page), more info # below startURL = "example.com" # default: "" # will be put in LESS environment variable lessOpts = "-FSXR~" # default: "-FSXR~ -P pager (q to quit)" searchURL = "geminispace.info/search" # this is the default
You can use a number of placeholders for your prompt (like PS1 in bash):
%U: Full url of current page including scheme (gemini://example.com/foo/bar)
%u: Full url of current page without scheme (example.com/foo/bar)
%P: Absolute path of the current url (/foo/bar)
%p: Base path of the current url (bar)
%% for a literal percent character, and percent-prefixed option that is not supported
will be ignored and presented literally.
The query part of the URL will be stripped for all options, for security reasons. (If the
input was to be sensitive -- 11 status code -- the full query percent-encoded would be
printed as the prompt, which could mean revealing passwords, etc. Hence the query including
? is stripped.)
Here are some examples:
config resulting prompt ------- ----------------- "%U>" "gemini://example.com/foo/bar> " "%P %%" "/foo/bar % " "%z>" "%z> " "%%%% $" "%% $ "
Gelim requires less(1) for paged output. If you don't have that installed, or is on windows, it will print the page directly and you'll have to scroll the page yourself. This is a bug and will be fixed in the near future.
--mouse (if your version of less supports it) to
in your config file.
Questions and general feedback:
#gelimon libera.chat irc for questions and suggestions
Bugs and feature requests
Pull request, patches