A terminal-based client for the Gemini protocol.
Project description
leo
a gemini client written in Python 3.
(UNIX-only, Windows support with WSL)
Instructions for use:
$ pip install leo-gmi
$ leo --copy-config
to create a config file in$XDG_CONFIG_HOME/leo
(falls back to~/.config/leo
)
- If you don't want to put the config file in either of those places,
leo --print-config
prints out the config that you can then supply to leo with the--config
option.
-
set options to your preferences in the
config.json
file.wrap_text
specifies whether to wrap text beyond a certain width.wrap_margin
specifies what that width should be.homepage
is a page to load by default if no URL is specified.cert_path
is the path to a certificate file.
Note: You can specify an alternate config file with the
--config
option. -
$ leo --url <url>
. If you do not specify a URL, the homepage set inconfig.json
is loaded. If no homepage is set, you will be prompted for a URL. -
if you'd like to connect providing a client certificate (required by certain Gemini servers), set the
"cert_path"
option in your config file to a valid path to a cert file. -
Links are preceded by a number that is underlined and violet in colour. Type in the number of the link at the
(URL/Num):
prompt in order to navigate to a specific link, or type in a URL. -
Type
reload
to refresh a page.reload hard
redownloads the page. -
back
takes you one page back. -
ls
lists all of the links on the current page, for easy navigation. -
Type
help
at any time to view a listing of these and other useful commands. -
Type
exit
orquit
to exit leo.
Features:
- Only uses the python standard library
- Fully implements Gemini spec
- Passes torture tests at gemini://gemini.conman.org/test/torture/ (Save for the final few Unicode ones, but Unicode support is hard)
- formatted text output with arbitrary wrapping support
- Comes with a built-in pager!
- Lets you save a list of URLs to a file for further viewing / opening in another window
Contributing
Fork the repo and make a PR! That's all :) You can alternatively send me an e-mail with your patch.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
File details
Details for the file leo_gmi-1.2.1-py3-none-any.whl
.
File metadata
- Download URL: leo_gmi-1.2.1-py3-none-any.whl
- Upload date:
- Size: 10.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.4.1 importlib_metadata/4.8.1 pkginfo/1.7.0 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.60.0 CPython/3.9.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
232d581267c172da59d423cf954add4493dc29be040a9df915946bf94931ff29
|
|
MD5 |
a8a327266833f3369d39ee4215aa2da8
|
|
BLAKE2b-256 |
9e01def9a6b42ba028711f2f4e421b86427bae311ace0b1f4f8ef297440cfa0d
|