rtv

Open the front page

$ /front

$ /r/[subreddit_name]

$ <Space>

$ <o>

$ <u>

$ <?>

rtv [subreddit]

subreddit
    The name of the subreddit to open. If no subreddit is provided, rtv will open your front page.

-h, --help
    Display help message and exit.

-v, --version
    Show version information and exit.

-c, --config-file
    Specify a custom configuration file path.

-l, --log-level
    Set the logging level (DEBUG, INFO, WARNING, ERROR, CRITICAL).

-u, --username
    Reddit username to automatically login with.

-p, --password
    Reddit password to automatically login with. Not recommended for security reasons.

-s, --subreddit
    Open to a specific subreddit

-n, --new
    Sort the subreddit by 'new'.

-t, --top
    Sort the subreddit by 'top'.

-H, --hot
    Sort the subreddit by 'hot'.

-q, --quiet
    Suppress all output except for errors.

rtv, or Reddit Terminal Viewer, is a curses-based frontend for browsing and interacting with Reddit. It provides a terminal-based interface for reading subreddits, viewing posts, reading and writing comments, voting on content, and performing other Reddit actions.

rtv aims to replicate the core functionality of the Reddit website within a text-based environment. It is particularly useful for users who prefer to work in the terminal, have limited bandwidth, or want a distraction-free Reddit experience. It offers customizable keyboard shortcuts and themes, enhancing user experience and enabling efficient navigation.

Using the Reddit API, rtv allows users to manage their accounts, follow specific subreddits, and engage with online communities directly from the terminal.

The Reddit API has rate limits, so excessive use of rtv might lead to temporary restrictions. Storing passwords directly in command-line arguments is highly discouraged due to security risks. Use a configuration file instead.

rtv uses a configuration file, typically located at ~/.config/rtv/rtv.cfg, to store settings such as keybindings, theme preferences, and authentication information. This file is automatically created the first time you run rtv. User can configure it with text editor. It provides a convenient and secure way to customize rtv's behavior.

rtv offers a comprehensive set of keybindings for navigating and interacting with Reddit content. Keybindings can be customized in the config file. Common keybindings include: j/k: Scroll down/up through posts.
o: Open the selected post in a web browser.
c: View comments for the selected post.
q: Quit the application.

To interact with Reddit (e.g., vote, comment, save posts), you need to authenticate with your Reddit account. rtv supports OAuth2 authentication, which is the recommended method. When you first try to perform an action that requires authentication, rtv will prompt you to log in via your web browser.

rtv was developed as an open-source project to provide a text-based Reddit browsing experience. It has gained popularity among users who prefer command-line interfaces or have limited bandwidth. The project continues to be actively maintained with regular updates and improvements based on community feedback.

curl(1), less(1), tmux(1), screen(1)