Archives/phetch
2
0
Fork 0
mirror of https://github.com/xvxx/phetch synced 2024-11-05 00:00:58 +00:00
Code Issues Releases Wiki Activity
571 Commits 4 Branches 29 Tags 147 MiB
Rust 99.2%
Makefile 0.8%
10d2bc2507
Go to file
dvkt 10d2bc2507 more bugs
2020-01-06 16:01:49 -08:00
.github/workflows quiet down the action output 2019-12-30 21:17:18 -08:00
img fix border 2019-12-23 23:52:34 -08:00
src don't print -h on arg fail 2020-01-06 10:38:34 -08:00
.gitignore debug log 2019-12-21 18:47:20 -08:00
build.rs just the date 2020-01-06 10:26:48 -08:00
Cargo.lock (cargo-release) start next development iteration 0.1.12-dev 2020-01-06 02:18:20 -08:00
Cargo.toml cargo build --features disable-tls 2020-01-06 10:26:58 -08:00
LICENSE MIT 2019-12-17 16:49:03 -08:00
Makefile the feature flag is now to negate tls, not enable it 2020-01-06 11:11:59 -08:00
README.md more bugs 2020-01-06 16:01:49 -08:00

README.md


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

features

  • <1MB executable for linux and mac
  • technicolor design (based on GILD)
  • no-nonsense keyboard navigation
  • supports gopher searches, text and menu pages, and downloads
  • save your favorite gopherholes with bookmarks
  • opt-in history
  • secure gopher support (TLS)

usage

phetch                           launch and show start page
phetch <gopher-url>              open gopher url
phetch -t, --tls <gopher-url>    attempt to open w/ tls
phetch -r, --raw <gopher-url>    print raw gopher response
phetch -l, --local               connect to 127.0.0.1:7070
phetch -h, --help                show this screen
phetch -v, --version             show phetch version

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

installation

binaries for linux, mac, and raspberry pi are available at https://github.com/dvkt/phetch/releases:

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

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 no-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

Menu View

Text View

todo

  • fork+exec telnet: gopher://bitreich.org/1/lawn/bbs
  • ~/.config/phetch/phetch.conf

bugs

  • "stream did not contain valid UTF-8" sdf.org/maps/
  • ctrl-z (suspend) doesn't work
  • unknown keypress: \n needs escaping
  • unknown keypress: [ during status messages
  • gopher://1436.ninja/1/twit.cgi ("iWritten and performed by Nathaniel" weirdness) (kitty only)
  • gopherpedia 'recent entries' weirdness (also kitty only)
  • gopher://alexschroeder.ch/2020-01-02_This_Gopher_Hole/menu

v1.0

  • Changelog generation (for gopher and github)
  • GIF screencast
  • man page (small one)

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