phetch/README.md

phetch is a terminal gopher client designed for quick keyboard navigation. It is the spiritual success to GILD.

features

• small (<1MB) executable for linux and macos
• technicolor design
• no nonsense keyboard navigation

usage

phetch <gopher-url>    # Show GopherHole at URL
phetch -r <gopher-url> # Print raw Gopher response.
phetch -h              # Show this screen.
phetch -v              # Show phetch version.

installation

phetch is available as a standalone executable for MacOS and Linux:

• MacOS: https://github.com/dvkt/phetch/releases/download/v0.1.0/phetch-macos.zip
• Linux x86_64: https://github.com/dvkt/phetch/releases/download/v0.1.0/phetch-linux-x86-64.tar.gz
• Linux ARM: https://github.com/dvkt/phetch/releases/download/v0.1.0/phetch-linux-arm.tar.gz

development

cargo run -- <gopher-url>

resources

• rfc 1346
• http://ascii-table.com/ansi-escape-sequences.php
• http://www.lihaoyi.com/post/BuildyourownCommandLinewithANSIescapecodes.html

TODO

Basics

• MENU: up/down scroll when next link out of view
• MENU: page up/page down show next page, highlight first link
• status() helper
• show errors in status()
• replace all panic! with errors
• replace all unwrap/expect with errors
• TLS
• MENU: open HTML link in browser
• ? to show all keyboard shortcuts
• search functionality
• download to ~/Downloads
• save history to file
• load history from file
• load most recent URL when opening without args

Bonus

• fuzzy find search links
  • https://github.com/stewart/rff
  • https://github.com/Schlechtwetterfront/fuzzy-rs
• detect SIGWINCH
  • https://github.com/BurntSushi/chan-signal