NAME¶

RTV - Reddit Terminal Viewer

SYNOPSIS¶

rtv [URL] [-s SUBREDDIT]

DESCRIPTION¶

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

OPTIONS¶

URL

[optional] Full URL of a submission to open

-h, --help

show this help message and exit

-s SUBREDDIT

Name of the subreddit that will be loaded on start

--log FILE

Log HTTP requests to the given file

--config FILE

Load configuration settings from the given file

--ascii

Enable ascii-only mode

--monochrome

Disable color

--theme FILE

Color theme to use, see --list-themes for valid options

--list-themes

List all of the available color themes

--non-persistent

Forget the authenticated user when the program exits

--no-autologin

Do not authenticate automatically on startup

--clear-auth

Remove any saved user data before launching

--copy-config

Copy the default configuration to {HOME}/.config/rtv/rtv.cfg

--copy-mailcap

Copy an example mailcap configuration to {HOME}/.mailcap

--enable-media

Open external links using programs defined in the mailcap config

-V, --version

show program's version number and exit

--no-flash

Disable screen flashing

--debug-info

Show system and environment information and exit

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.

FILES¶

$XDG_CONFIG_HOME/rtv/rtv.cfg

The configuration file can be used to customize default program settings.

$XDG_DATA_HOME/rtv/refresh-token

After you login to reddit, your most recent OAuth refresh token will be stored for future sessions.

$XDG_DATA_HOME/rtv/history.log

This file stores URLs that have been recently opened in order to visually highlight them as "seen".

ENVIRONMENT¶

RTV_EDITOR

Text editor to use when editing comments and submissions. Will fallback to $EDITOR.

RTV_URLVIEWER

Url viewer to use to extract links from comments. Requires a compatible program to be installed.

RTV_BROWSER

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)