You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
kakuhen fee4e316e3 Update README.md 5 months ago
.cargo Have the linker strip the binary (cross-compile friendly) 2 years ago
.github/workflows not anymore 2 years ago
benchmarks put benchmarks in sub-crate to cut down on dev deps 1 year ago
doc update manual 1 year ago
img Add some "screenshots" to the repo: 1 year ago
src ctrl-e or just e 1 year ago
tests cp437 test 1 year ago
.gitignore ignore conf 1 year ago
CHANGELOG.md (cargo-release) version 1.1.0 1 year ago
Cargo.lock (cargo-release) start next development iteration 1.1.1-dev 1 year ago
Cargo.toml (cargo-release) start next development iteration 1.1.1-dev 1 year ago
Cross.toml wrong file 2 years ago
LICENSE MIT 2 years ago
Makefile make test 1 year ago
README.md Update README.md 2 weeks ago
build.rs char 2 years ago

README.md


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


demo of phetch in action

features

  • <1MB executable for Linux, Mac, and NetBSD
  • Technicolor design (based on GILD)
  • No-nonsense keyboard navigation
  • Supports Gopher searches, text and menu pages, and downloads
  • Save your favorite Gopher sites with bookmarks
  • Opt-in history tracking
  • Secure Gopher support (TLS)
  • Tor support

usage

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

    -w, --wrap COLUMN      Wrap long lines in "text" views at COLUMN.
    -m, --media PROGRAM    Use to open media files. Default: mpv
    -M, --no-media         Just download media files, don't download

    -r, --raw              Print raw Gopher response only
    -p, --print            Print rendered Gopher response only
    -l, --local            Connect to 127.0.0.1:7070
    -e, --encoding         Render text documents in CP437 or UTF8.

    -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

If you already have a Gopher client, download phetch here:

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

On macOS you can install with Homebrew or MacPorts.

If you're using Homebrew, open the Terminal and type:

brew install xvxx/code/phetch

For MacPorts:

sudo port install phetch

On Arch Linux, install phetch with your favorite AUR helper:

yay phetch

On NetBSD, phetch is included in the main pkgsrc repo:

pkgin install 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 if you have cargo, make, and the other dependencies described in the next section:

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

development

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

sudo apt install -y pkg-config libssl-dev

Regular development uses cargo:

cargo run -- <gopher-url>

Pro-tip: Run a local gopher server (like phd) on 0.0.0.0:7070 and start phetch with -l or --local to quickly connect to it. Useful for debugging!

phetch builds with TLS and Tor support by default. To disable these features, or to enable only one of them, use the --no-default-features flag:

cargo build --no-default-features

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

cargo run --no-default-features -- gopher://phetch/about

To enable just TLS support, or just Tor support, use --features:

cargo run --no-default-features --features tor -- gopher://phetch/about

media player support

phetch includes support for opening video files (; item type) and sound files (s item type) in mpv or an application of your choice using the -m command line flag. To test it out, visit a compatible Gopher server (maybe one using Gophor?). Or check out the "gopher types" help page by pressing ctrl-h then 3 in phetch.

todo

  • ctrl-c in load() not yet implemented

bugs

  • telnet IO seems broken after raw_input change (1146f42)

future features

  • track binary size per release
  • text views are menus when URLs are present (one per line max)
  • Find Text in Text views
  • fuzzy find incremental search
  • persistent history
  • bookmarks: toggle instead of just prepending to the file
  • bookmarks: save the title of the current page