You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
phetch/README.md

83 lines
2.3 KiB
Markdown

5 years ago
````
/ / /
___ (___ ___ (___ ___ (___
| )| )|___)| | | )
|__/ | / |__ |__ |__ | /
|
````
<p align="center">
<img src="https://img.shields.io/badge/license-apache_2.0-blueviolet?style=flat-square">
<img src="https://img.shields.io/badge/current_release-0.0.0-brightgreen.svg?style=flat-square">
<img src="https://img.shields.io/badge/dev_version-0.1.0--dev-lightgrey.svg?style=flat-square">
</p>
5 years ago
`phetch` is a terminal gopher client designed for quick keyboard navigation. It is the spiritual success to [GILD](https://github.com/dvkt/gild).
5 years ago
5 years ago
## features
5 years ago
5 years ago
- small (<1MB) executable for linux and macos
5 years ago
- technicolor design
5 years ago
- no nonsense keyboard navigation
5 years ago
## usage
phetch <gopher-url> # Show GopherHole at URL
phetch -raw <gopher-url> # Print raw Gopher response.
phetch -help # Show this screen.
phetch -version # Show phetch version.
5 years ago
## installation
MacOS:
wget https://github.com/dvkt/phetch/releases/download/v0.1.0/phetch-macos.zip
unzip phetch-macos.zip
./phetch -h
Linux x86_64:
wget https://github.com/dvkt/phetch/releases/download/v0.1.0/phetch-linux-x86-64.zip
unzip phetch-linux-x86-64.zip
./phetch -h
Linux ARM:
wget https://github.com/dvkt/phetch/releases/download/v0.1.0/phetch-linux-arm.zip
unzip phetch-linux-arm.zip
./phetch -h
5 years ago
## development
5 years ago
cargo run -- <gopher-url>
5 years ago
## resources
5 years ago
- [rfc 1346](https://tools.ietf.org/html/rfc1436)
5 years ago
- http://ascii-table.com/ansi-escape-sequences.php
5 years ago
5 years ago
## TODO
### Basics
5 years ago
- [ ] MENU: up/down scroll when next link out of view
- [ ] MENU: page up/page down show next page, highlight first link
5 years ago
- [ ] status() helper
- [ ] show errors in status()
- [ ] replace all panic! with errors
- [ ] replace all unwrap/expect with errors
- [ ] TLS
5 years ago
- [ ] MENU: open HTML link in browser
5 years ago
- [ ] `?` to show all keyboard shortcuts
5 years ago
- [ ] search functionality
5 years ago
- [ ] download to ~/Downloads
- [ ] save history to file
- [ ] load history from file
- [ ] load most recent URL when opening without args
### Bonus
5 years ago
- [ ] fuzzy find search links
- https://github.com/stewart/rff
- https://github.com/Schlechtwetterfront/fuzzy-rs
- [ ] detect SIGWINCH
- https://github.com/BurntSushi/chan-signal