Skip to content

tleino/gemsurf

Repository files navigation

gemsurf

A simple interface to gemcache. The gemcache daemon fetches content
over the Gemini protocol. The gemsurf interface accepts commands
from standard input stream. The gemsurf interface is meant to be used
through an actual user interface, such as a graphical interface, or
through an edbrowse(1)-like interface, i.e. the commands are meant to
be "typed" by an another command, i.e. gemsurf is meant to be a plugin
to an another program.

Commands
========

b <url>
	browse to an URL
l <line number>
	show source code for the given line
x <line number>
	execute link on the given line
q
	quit

Command line options
====================

-n
	show line numbers (useful when testing)
-p
	set prompt

Caveats
=======

At the moment gemcache is expected to be running at 127.0.0.1:1965.

Dependencies
============

- gemcache (https://github.com/tleino/gemcache)

Configure & Install
===================

./configure ~
make install

Example
=======

Using through a line-based editor/pager interface:

echo >~/.xd 'plugin gemsurf ^gemini://.*'
xd
e gemini://gemini.circumlunar.space/
1,10p
/=
l
x
/=

Using raw:

gemsurf -p'> ' -n gemini://gemini.circumlunar.space/
l 15
x 15

See also
========

https://github.com/tleino/gemcache
https://github.com/tleino/xd

About

A raw client to the Gemini space, requires gemcache and a separate user interface, such as xd(1)

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published