GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — GitHub - ozan2003/rfc_reader: An RFC viewer with TUI

BranchesTags
Open more actions menu

Latest commit

 

History

227 Commits
227 Commits

Folders and files

NameName
Last commit message
Last commit date
.cargo
.cargo
 
 
.github/workflows
.github/workflows
 
 
src
src
 
 
.gitignore
.gitignore
 
 
CHANGELOG.md
CHANGELOG.md
 
 
Cargo.lock
Cargo.lock
 
 
Cargo.toml
Cargo.toml
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
clippy.toml
clippy.toml
 
 
dist-workspace.toml
dist-workspace.toml
 
 
rust-toolchain.toml
rust-toolchain.toml
 
 
rustfmt.toml
rustfmt.toml
 
 

Repository files navigation

RFC Reader

License: MIT Rust Stars Last Commit Code Size dependency status Built With Ratatui

A terminal-based interface for reading IETF RFCs (Request for Comments), enabling you to fetch, cache, and browse them with ease.

Features

  • View documents directly in the terminal
  • Automatic caching of the documents for offline reading
  • Text search functionality within document
  • Table of contents navigation

Note

Table of contents section might not always be accurate, as there's no standard way to extract it from RFCs. It works best with RFCs that have a well-defined TOC.

  • Keyboard controls

Screenshots

rfc-reader-normal.png

rfc-reader-toc.png

rfc-reader-search.png

Usage

rfc_reader [OPTIONS] [RFC_NUMBER]

Examples

# Read a specific RFC
rfc_reader 2616

# Read a specific RFC in offline mode (only works if previously cached)
rfc_reader --offline 2616

# Clear the RFC cache
rfc_reader --clear-cache

Options

  • --offline, -o: Run in offline mode (only load cached RFCs)
  • --clear-cache: Clear the RFC cache

Refer to rfc_reader --help for more options.

Controls

Refer to the wiki for keybindings.

Cache Location

RFCs are cached locally to improve performance and enable offline reading.

Linux:

/home/{YOUR_USERNAME}/.config/rfc_reader

MacOS:

/Users/{YOUR_USERNAME}/Library/Application Support/rfc_reader

Windows:

C:\Users\{YOUR_USERNAME}\AppData\Roaming\rfc_reader\config

Contributing

I don't know very well about contribution/PR stuff. Contact me or create an issue if for any issues or suggestions.

License

This project is licensed under the MIT License. See the LICENSE file for details.

About

An RFC viewer with TUI

Topics

argument-parsingcachingcommand-line-interfacehttp-requestoffline-capabilitiesratatuireader-uirequest-for-commentsrfcsrusttable-of-contentstext-searchtuiviewers

Resources

Readme
MIT license
Activity

Stars

73 stars

Watchers

3 watching

Forks

3 forks
Report repository

Releases

Packages

Used by

Contributors

Languages

You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.