Skip to content

ozan2003/rfc_reader

Repository files navigation

RFC Reader

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

A tool to read IETF RFCs (Request for Comments) with a TUI, allowing you to fetch, cache, and browse them.

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.

Minimum Supported Rust Version (MSRV)

Rust 1.88.0 or newer.

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 a issue if for any issues or suggestions.

License

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