RTV(1)

📦 version 1.27.0, in debian bookworm, ubuntu jammy, ubuntu noble

💖 RTV — Reddit Terminal Viewer 💖

okay bestie, sit down, because i'm about to put you onto something life-changing. This right here is the manual page for RTV, the Reddit Terminal Viewer — it's the RTV(1) page, if you're being all formal about it. 🌸

✨ SYNOPSIS ✨

rtv [URL] [-s SUBREDDIT]

like. that's it. that's the whole summoning ritual. 💅

🦋 DESCRIPTION 🦋

RTV (Reddit Terminal Viewer) is a terminal interface to view and interact with reddit.

not just view, bestie — interact. you can actually do stuff. main character energy, fr fr. 👑

🎀 OPTIONS 🎀

  • URL — [optional] the full URL of a submission to open. hand it a link, it opens that link. no link? it just does its thing. no pressure. 🫶
  • -h, --help — shows this help message and exits. bye bestie ✌️
  • -s SUBREDDIT — the name of the subreddit that gets loaded the moment you start up.
  • --log FILE — logs the HTTP requests into whatever file you name here. receipts! 🧾
  • --config FILE — loads your configuration settings from this file.
  • --ascii — turns on ascii-only mode. pure characters, no fancy glyphs, rustic era.
  • --monochrome — disables color. beige. neutral. respectfully. 🤎
  • --theme FILE — the color theme to use. peep --list-themes for the valid options, don't just guess.
  • --list-themes — lists every single available color theme. window shopping 🛍️
  • --non-persistent — forgets the authenticated user when the program exits. like it never even happened. 💀
  • --no-autologin — does not authenticate automatically on startup. you do it yourself, on your own time.
  • --clear-auth — removes any saved user data before launching. yeet 🗑️
  • --copy-config — copies the default configuration to {HOME}/.config/rtv/rtv.cfg
  • --copy-mailcap — copies an example mailcap configuration to {HOME}/.mailcap
  • --enable-media — opens external links using programs defined in the mailcap config.
  • -V, --version — shows the program's version number and exits.
  • --no-flash — disables screen flashing. for the sensitive girlies 🙈
  • --debug-info — shows system and environment information and exits. spill the tea about your machine ☕

🎮 CONTROLS 🎮

Move the cursor using the arrow keys or vim style movement.

Press up and down to scroll through submissions.

Press right to view the selected submission and left to return.

Press ? to open the help screen.

literally muscle memory after like two days. you'll be fluent. 😌

📁 FILES 📁

  • $XDG_CONFIG_HOME/rtv/rtv.cfg — the configuration file, and you can use it to customize the default program settings. make it yours.
  • $XDG_DATA_HOME/rtv/refresh-token — after you login to reddit, your most recent OAuth refresh token gets stored right here for future sessions. 🔑
  • $XDG_DATA_HOME/rtv/history.log — this file stores URLs that have been recently opened, so they can be visually highlighted as "seen". the group chat remembers everything. 👀

🌈 ENVIRONMENT 🌈

  • RTV_EDITOR — the text editor to use when editing comments and submissions. will fallback to $EDITOR.
  • RTV_URLVIEWER — the url viewer to use to extract links from comments. requires a compatible program to be installed.
  • RTV_BROWSER — the web browser to use when opening links. will fallback to $BROWSER.

👑 AUTHOR 👑

Michael Lazar <lazar.michael22@gmail.com> (2017).

💀 BUGS 💀

Report bugs to https://github.com/michael-lazar/rtv/issues

📜 LICENSE 📜

The MIT License (MIT)

and that's the whole page, bestie. this was Version 1.27.0, dated June 03, 2019 — so go forth, open your terminal, and have the most iconic reddit experience of your life. no cap. 🦋✨🎀

📦 where this page comes from