Home

Awesome

ncgopher

ncgopher is a gopher, gemini and finger client for the modern internet. It uses ncurses and is written in Rust.

gopher

Gopher was developed in 1991 at the University of Minnesota, and named after the school's mascot. Gopher is a menu-driven interface that allows a user to browse for text information served off of various gopher servers.

gemini

Gemini is a new application-level internet protocol for the distribution of arbitrary files, with some special consideration for serving a lightweight hypertext format which facilitates linking between files.

Screenshot

Obligatory screenshot:

img

img

Features

Installation

Arch Linux

Arch Linux users can install ncgopher using pacman:

sudo pacman -S ncgopher-git

NixOS

NixOS users can install ncgopher using nix-env:

nix-env -iA nixos.ncgopher

FreeBSD

doas pkg install ncgopher

NetBSD

NetBSD users can install ncgopher using pkgin:

pkgin install ncgopher

All other systems

ncgopher has no fancy installation process right now. There are some external dependencies which have to be installed. First and foremost you will of course need to have Rust installed. Further dependencies are the openssl, ncurses and sqlite3 libraries. If these are not installed, the build will fail but you will most likely be able to tell what is missing.


Debian-based Linux

sudo apt install build-essential pkg-config libssl-dev libncurses-dev libsqlite3-dev

Arch-based Linux

sudo pacman -S base-devel pkg-config openssl ncurses sqlite

OpenBSD

doas pkg_add sqlite3 rust

MSYS2 (Windows, MINGW64 terminal)

pacman -S base-devel mingw-w64-x86_64-pkgconf mingw-w64-x86_64-rust mingw-w64-x86_64-ncurses mingw-w64-x86_64-openssl mingw-w64-x86_64-sqlite3

If you know how to install the listed dependencies on your operating system and it is not listed, please make a pull request to add it.

After installing these dependencies run

cargo install ncgopher

To install the latest development version:

git clone https://github.com/jansc/ncgopher.git
cd ncgopher
cargo build
cargo run

Key bindings

During alpha, many operations are still not implemented. Key bindings can be changed by adding a keybindings section in your config.toml, if you want to change them from the defaults below:

KeyCommand
Arrow keysMove around in text
EnterOpen the link under the cursor
EscGo to menubar
SpaceScroll down one page
gOpen new URL
GEdit current URL
bNavigate back
qClose application
sSave current page
rReload current page
iShow link under cursor
aAdd bookmark for current page
lGo to next link
LGo to previous link
jMove one line down
kMove one line up
/Search in text
nMove to next search result
NMove to previous search result

Here is an example config.toml with all the keybindings defined:

[keybindings]
open_new_url = 'o'
edit_current_url = 'e'
navigate_back = 'h'
close = 'q'
save_page = 's'
reload_page = 'r'
show_link = 'i'
add_bookmark = 'b'
next_link = 'l'
previous_link = 'L'
move_down = 'j'
move_up = 'k'
search_in_text = '/'
next_search_result = 'n'
previous_search_result = 'N'
show_help = '?'

Mouse support

ncgopher supports mouse interaction for menus and buttons in dialogs. If you want to select text, most terminal support selection while pressing SHIFT.

Debugging

The software is still in beta, and it is also my first application written in Rust. Expect lots of bugs and badly written Rust code.

If the application crashes, I'd be interested in a log file. To produce one, please rerun the program with the command line flag -d and a file name to store the log in, for example "error.log". It should look something like this: ncgopher -d error.log This will append log messages to error.log (the file will be created if it does not exist). With this, try to reproduce the bug and take note of the backtrace output.

If you know how to do that and you installed the source, you can run the program with RUST_BACKTRACE to get a backtrace too.

License

ncgopher is licensed under the BSD 2-clause license.

Copyright (c) 2019-2022 The ncgopher Authors. Parts of the status bar implementation are Copyright (c) 2019, Henrik Friedrichsen