3.1 KiB
PHETCH(1)
NAME
phetch - quick lil gopher client
SYNOPSIS
phetch [OPTIONS] [URL]
OPTIONS
-l, --local Connect to the local Gopher server at URL 127.0.0.1:7070.
-p URL, --print URL Print a rendered Gopher server response of URL and exit.
-r URL, --raw URL Print the raw Gopher server response of URL and exit.
-t, --tls Attempt to fetch all pages over TLS.
-T, --tor Make all connections using a local Tor proxy. Set the TOR_PROXY env variable to use an address other than the Tor default of 127.0.0.1:9050.
-h, --help Print a help summary and exit.
-v, --version Print version information and exit.
NOTES
When given a URL, phetch will show the requested Gopher page and enter interactive mode.
Without a URL, phetch will show a builtin dashboard with easy access to online help, bookmarks and history, and enter interactive mode.
NAVIGATION
KEYBOARD SHORTCUTS
All single letter commands also work with the Ctrl key: e.g., h and Ctrl-h are synonyms.
h Go to builtin help page. q Quit phetch.
left arrow Go back in history. right arrow Go forward in history. up arrow, p, k Select previous link. down arrow, n, j Select next link. PgUp, - Scroll up by many lines. PgDn, SPACE Scroll down by many lines.
Number key Open/select link. Enter Open current link. Esc, Ctrl-c Cancel
f, / Find link in page.
g Go to Gopher URL. u Edit URL. y Copy URL.
b Show bookmarks. s Save bookmark. a Show history. (Mnemonic: All pages/history)
r View raw source. w Toggle wide mode.
MENU NAVIGATION
Up and down arrows Use the up and down arrows, j and k keys, or n and p keys to select links. Phetch will scroll for you, or you can use page up and page down (or - and spacebar) to scroll by many lines at once.
Number keys If there are few enough menu items, pressing a number key will open a link. Otherwise, the first matching number will be selected. Use Enter to open the selected link.
Incremental search Press f or / to activate search mode, then just start typing. Phetch will look for the first case-insensitive match and try to select it. Use arrow keys or Ctrl-p/Ctrl-n to cycle through matches.
BOOKMARKS
There are two ways to save the URL of the current page:
y Copy URL. s Save bookmark.
Bookmarks will be saved to the file ~/.config/phetch/bookmarks.gph if the directory ~/.config/phetch/ exists.
b View saved bookmarks.
The clipboard function uses pbcopy on MacOS, and xsel -sel clip on Linux.
HISTORY
If you create a history.gph file in ~/.config/phetch/, each Gopher URL you open will be stored there.
New URLs are appended to the bottom, but loaded in reverse order, so you'll see all the most recently visited pages first when you press the a key.
Feel free to edit your history file directly, or share it with your friends!
ABOUT
Phetch is maintained by dvkt, and released under the MIT license.
Phetch's Gopher hole: gopher://phkt.io/1/phetch Phetch's webpage: https://github.com/dvkt/phetch