{"id":13961543,"url":"https://github.com/xvxx/phetch","last_synced_at":"2025-12-27T01:23:14.462Z","repository":{"id":38331049,"uuid":"190620967","full_name":"xvxx/phetch","owner":"xvxx","description":"🐭 quick lil gopher client for your terminal","archived":false,"fork":false,"pushed_at":"2023-06-21T22:50:32.000Z","size":8997,"stargazers_count":194,"open_issues_count":5,"forks_count":6,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-21T06:49:08.914Z","etag":null,"topics":["cli","console","gopher","gopher-client","gopher-protocol","rust","terminal","tui"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xvxx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2019-06-06T17:19:01.000Z","updated_at":"2025-07-05T17:25:30.000Z","dependencies_parsed_at":"2024-01-15T03:59:42.111Z","dependency_job_id":"ce2bcf98-c46c-418f-ae5b-56de5a3b3264","html_url":"https://github.com/xvxx/phetch","commit_stats":{"total_commits":919,"total_committers":9,"mean_commits":"102.11111111111111","dds":"0.31011969532100114","last_synced_commit":"d0b503ebcf4b1992ca40906c03bba96b78ffd7ae"},"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"purl":"pkg:github/xvxx/phetch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvxx%2Fphetch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvxx%2Fphetch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvxx%2Fphetch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvxx%2Fphetch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xvxx","download_url":"https://codeload.github.com/xvxx/phetch/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xvxx%2Fphetch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28067532,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-26T02:00:06.189Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","console","gopher","gopher-client","gopher-protocol","rust","terminal","tui"],"created_at":"2024-08-08T17:01:14.957Z","updated_at":"2025-12-27T01:23:14.446Z","avatar_url":"https://github.com/xvxx.png","language":"Rust","funding_links":[],"categories":["Rust"],"sub_categories":[],"readme":"\u003c!--\n      /         /         /\n ___ (___  ___ (___  ___ (___\n|   )|   )|___)|    |    |   )\n|__/ |  / |__  |__  |__  |  /\n|\n--\u003e \u003cp align=\"center\"\u003e \u003cimg src=\"./img/logo.png\"\u003e \u003cbr\u003e\n\u003ca href=\"https://git.io/JveQo\"\u003e\n\u003cimg src=\"https://img.shields.io/github/v/release/xvxx/phetch\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://crates.io/crates/phetch\"\u003e\n\u003cimg src=\"https://img.shields.io/crates/v/phetch\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://aur.archlinux.org/packages/phetch/\"\u003e\n\u003cimg src=\"https://img.shields.io/aur/version/phetch\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://git.io/JvR5g\"\u003e\n\u003cimg src=\"https://github.com/xvxx/phetch/workflows/build/badge.svg\"\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n`phetch` is a terminal client designed to help you quickly navigate\nthe gophersphere.\n\n\u003chr\u003e\n\n![demo of phetch in action](img/phetch-demo.gif \"demo of phetch\")\n\n## features\n\n- \u003c1MB executable for Linux, Mac, and NetBSD\n- Technicolor design (based on [GILD](https://github.com/xvxx/gild))\n- No-nonsense keyboard navigation\n- Supports Gopher searches, text and menu pages, and downloads\n- Save your favorite Gopher sites with bookmarks\n- Opt-in history tracking\n- Secure Gopher support (TLS)\n- Tor support\n\n## usage\n\n    Usage:\n\n        phetch [options]       Launch phetch in interactive mode\n        phetch [options] url   Open Gopher URL in interactive mode\n\n    Options:\n\n        -s, --tls              Try to open Gopher URLs securely w/ TLS\n        -o, --tor              Use local Tor proxy to open all pages\n        -S, -O                 Disable TLS or Tor\n\n        -w, --wrap COLUMN      Wrap long lines in \"text\" views at COLUMN.\n        -m, --media PROGRAM    Use to open media files. Default: mpv\n        -M, --no-media         Just download media files, don't download\n        -a, --autoplay         Autoplay media files without prompting.\n        -A, --no-autoplay      Prompt before playing media files.\n\n        -r, --raw              Print raw Gopher response only\n        -p, --print            Print rendered Gopher response only\n        -l, --local            Connect to 127.0.0.1:7070\n        -e, --encoding         Render text documents in CP437 or UTF8.\n\n        -c, --config FILE      Use instead of ~/.config/phetch/phetch.conf\n        -C, --no-config        Don't use any config file\n        -t, --theme FILE       Use FILE for color theme or print current theme.\n        --print-theme          Print current theme.\n\n        -h, --help             Show this screen\n        -v, --version          Show phetch version\n\n    Command line options always override options set in phetch.conf.\n\n    Once you've launched phetch, use `ctrl-h` to view the on-line help.\n\n## installation\n\nIf you already have a Gopher client, download `phetch` here:\n\n    gopher://phkt.io/1/phetch/latest\n\nOn macOS you can install with [Homebrew](https://brew.sh/)\nor [MacPorts](https://macports.org).\n\nIf you're using Homebrew, open the Terminal and type:\n\n    brew install xvxx/code/phetch\n\nFor MacPorts:\n\n    sudo port install phetch\n\nOn Arch Linux, install phetch with your favorite [AUR helper][aur]:\n\n    yay phetch\n\nOn NetBSD, phetch is included in the main pkgsrc repo:\n\n    pkgin install phetch\n\nBinaries for Linux, Raspberry Pi, Mac and Android (termux) are available at\nhttps://github.com/xvxx/phetch/releases:\n\n- [phetch-v1.2.0-linux-x86_64.tgz][0]\n- [phetch-v1.2.0-linux-armv7.tgz (Raspberry Pi)][1]\n- [phetch-v1.2.0-macos.zip][2]\n\nJust unzip/untar the `phetch` program into your `$PATH` and get going!\n\nYou can also build and install from source if you have `cargo`,\n`make`, and the other dependencies described in the next section:\n\n    git clone https://github.com/xvxx/phetch\n    cd phetch\n    env PREFIX=/usr/local make install\n\nFor Termux use:\n\n    env PREFIX=/data/data/com.termux/files/usr make install\n\n## development\n\nTo build with TLS support on **Linux**, you need `openssl` and\n`pkg-config`:\n\n    sudo apt install -y pkg-config libssl-dev\n\nRegular development uses `cargo`:\n\n    cargo run -- \u003cgopher-url\u003e\n\n_Pro-tip:_ Run a local gopher server (like [phd]) on `0.0.0.0:7070`\nand start phetch with `-l` or `--local` to quickly connect to it.\nUseful for debugging!\n\nphetch builds with TLS and Tor support by default. To disable these\nfeatures, or to enable only one of them, use the\n`--no-default-features` flag:\n\n    cargo build --no-default-features\n\nYou can check whether TLS is enabled by visiting the About page:\n\n    cargo run --no-default-features -- gopher://phetch/about\n\nTo enable just TLS support, or just Tor support, use `--features`:\n\n    cargo run --no-default-features --features tor -- gopher://phetch/about\n\n## media player support\n\nphetch includes support for opening video files (`;` item type) and\nsound files (`s` item type) in [mpv] or an application of your choice\nusing the `-m` command line flag. To test it out, visit a compatible\nGopher server (maybe one using [Gophor]?). Or check out the \"gopher\ntypes\" help page by pressing `ctrl-h` then `3` in phetch.\n\n## todo\n\n- [ ] ctrl-c in load() not yet implemented\n\n## bugs\n\n- [ ] telnet IO seems broken after raw_input change (1146f42)\n\n## future features\n\n- [ ] track binary size per release\n- [ ] text views are menus when URLs are present (one per line max)\n- [ ] Find Text in Text views\n- [ ] fuzzy find incremental search\n- [ ] persistent history\n- [ ] bookmarks: toggle instead of just prepending to the file\n- [ ] bookmarks: save the title of the current page\n\n[0]: https://github.com/xvxx/phetch/releases/download/v1.2.0/phetch-v1.2.0-linux-x86_64.tgz\n[1]: https://github.com/xvxx/phetch/releases/download/v1.2.0/phetch-v1.2.0-linux-armv7.tgz\n[2]: https://github.com/xvxx/phetch/releases/download/v1.2.0/phetch-v1.2.0-macos.zip\n[phd]: https://github.com/xvxx/phd\n[aur]: https://wiki.archlinux.org/index.php/AUR_helpers\n[mpv]: https://github.com/mpv-player/mpv\n[gophor]: https://github.com/grufwub/gophor\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxvxx%2Fphetch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxvxx%2Fphetch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxvxx%2Fphetch/lists"}