phetch is a terminal client designed to help you quickly navigate the gophersphere.

features

usage

    phetch [options]          Launch phetch in interactive mode
    phetch [options] [url]    Open Gopher URL in interactive mode

Options:

    -s, --tls                 Try to open Gopher URLs securely w/ TLS
    -o, --tor                 Use local Tor proxy to open all pages
    -S, -O                    Disable TLS or Tor

    -r, --raw                 Print raw Gopher response only
    -p, --print               Print rendered Gopher response only
    -l, --local               Connect to 127.0.0.1:7070

    -c, --config FILE         Use instead of ~/.config/phetch/phetch.conf
    -C, --no-config           Don't use any config file   

    -h, --help                Show this screen
    -v, --version             Show phetch version

Command line options always override options set in phetch.conf.

Once you've launched phetch, use `ctrl-h` to view the on-line help.

installation

On macOS you can install with Homebrew:

brew install xvxx/code/phetch

Binaries for Linux, Raspberry Pi, and Mac are available at https://github.com/xvxx/phetch/releases:

Just unzip/untar the phetch program into your $PATH and get going!

You can also build and install from source:

git clone https://github.com/xvxx/phetch
cd phetch
env PREFIX=/usr/local make install

updates

To check for new versions of phetch, use the on-line help system in the app (ctrl-h) or visit:

gopher://phkt.io/1/phetch/latest

development

cargo run -- <gopher-url>

Pro-tip: Run a local gopher server on 127.0.0.1:7070 and start phetch with -l or --local to quickly connect to it.

To build with TLS support on Linux, you need openssl and pkg-config:

sudo apt install -y pkg-config libssl-dev

To build without TLS support, build with the disable-tls feature:

cargo build --features disable-tls

You can check whether TLS is enabled by visiting the About page:

cargo run --features disable-tls -- gopher://phetch/about

screenies

|DOS Archive|Floodgap| |:-:|:-:| | DOS Archive | Floodgap |

bugs

v1.0

future features