Skip to main content

A simple terminal viewer for Reddit (Reddit Terminal Viewer)

Project description

Reddit Terminal Viewer (RTV) is a lightweight browser for Reddit (www.reddit.com) built into a terminal window. RTV is built in Python and utilizes the curses library. It is compatible with a large range of terminal emulators on Linux and OSX systems.

http://i.imgur.com/4a3Yrov.gif

Installation

Reddit Terminal Viewer is Py2/Py3 compatible. The quickest way to install is through pip.

$ sudo pip install --pre rtv

Alternatively, you can install directly from the repo using python setuptools.

$ git clone https://github.com/michael-lazar/rtv.git
$ cd rtv
$ sudo python setup.py install

After the installation has finished, a script will be placed in the system path. The program can then be started by typing

$ rtv

Additional options can be viewed with

$ rtv --help

Usage

RTV currently supports browsing both subreddits and individual submissions. In each mode the controls are slightly different.

Global Commands

Arrow Keys or hjkl:

RTV supports both the arrow keys and vim bindings for navigation. Move up and down to scroll through items on the page.

r or F5:

Refresh the current page.

q:

Quit the program.

Subreddit Mode

In subreddit mode you can browse through the top submissions on either the front page or a specific subreddit.

Right or Enter:

Open the currently selected submission in a new page.

/:

Open a prompt to switch to a different subreddit. For example, pressing / and typing python will open /r/python. You can return to Reddit’s front page by using the alias /r/front.

o:

Opens the url for a link-post in the default browser.

Submission Mode

In submission mode you can view the self text for a submission and browse comments.

Right or Enter:

Toggle the currently selected comment between hidden and visible. Alternatively, load additional comments identified by [+] more comments.

Left:

Exit the submission page and return to the subreddit.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rtv-1.0a4.tar.gz (12.0 kB view hashes)

Uploaded Source

Built Distribution

rtv-1.0a4-py2.py3-none-any.whl (15.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page