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

72 lines
2.0 KiB
Markdown

<p align="center">
<img src="./phetch.png">
<br> <br>
<a href="LICENSE">
<img src="https://img.shields.io/badge/license-MIT-blueviolet?style=flat-square">
</a>
<a href="https://github.com/dvkt/phetch/releases/tag/v0.0.0">
<img src="https://img.shields.io/badge/current_release-0.0.0-brightgreen.svg?style=flat-square">
</a>
<a href="https://github.com/dvkt/phetch">
<img src="https://img.shields.io/badge/dev_version-0.1.0--dev-lightgrey.svg?style=flat-square">
</a>
</p>
`phetch` is a terminal gopher client designed for quick keyboard navigation. It is the spiritual successor to [GILD](https://github.com/dvkt/gild).
**features:**
- small (<1MB) executable for linux and mac
- 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
Binaries for Linux and Mac are available at https://github.com/dvkt/phetch/releases
Just unzip/untar the `phetch` program into your $PATH get going!
You can also build from source using `cargo build --release`, if you want.
## development
cargo run -- <gopher-url>
## resources
- [rfc 1346](https://tools.ietf.org/html/rfc1436)
- http://ascii-table.com/ansi-escape-sequences.php
- http://www.lihaoyi.com/post/BuildyourownCommandLinewithANSIescapecodes.html
## TODO
### Basics
- [ ] open local files
- [ ] download to ~/Downloads
- [ ] `?` to show all keyboard shortcuts
- [ ] save history to file
- [ ] load history from file
- [ ] load most recent URL when opening without args
### Bonus
- [ ] async gopher request
- [ ] TLS
- [ ] fuzzy find search links
- https://github.com/stewart/rff
- https://github.com/Schlechtwetterfront/fuzzy-rs
- [ ] detect SIGWINCH
- https://github.com/BurntSushi/chan-signal
## Screenies
![Links](./img/links.png)
![DOS Menu](./img/menu.png)
![Game Archive](./img/oldies.png)