A simple terminal viewer for Reddit (Reddit Terminal Viewer)
Project description
RTV: Reddit Terminal Viewer
RTV is an application that allows you to view and interact with reddit from your terminal. It is compatible with most terminal emulators on Linux and OSX.
RTV is built in python using the curses library.
Installation
Install using pip
$ sudo pip install rtv
Or clone the repository
$ git clone https://github.com/michael-lazar/rtv.git
$ cd rtv
$ sudo python setup.py install
The installation will place a script in the system path
$ rtv
$ rtv --help
Configuration
RTV will read a configuration file located at $XDG_CONFIG_HOME/rtv/rtv.cfg or ~/.config/rtv/rtv.cfg if $XDG_CONFIG_HOME is not set. This can be used to avoid having to re-enter login credentials every time the program is launched. Each line in the file will replace the corresponding default argument in the launch script.
Example config:
[rtv]
username=MyUsername
password=MySecretPassword
# Log file location
log=/tmp/rtv.log
# Default subreddit
subreddit=CollegeBasketball
# Default submission link - will be opened every time the program starts
# link=http://www.reddit.com/r/CollegeBasketball/comments/31irjq
# Enable unicode characters (experimental)
# This is known to be unstable with east asian wide character sets
# unicode=true
RTV allows users to compose comments and replys using their preferred text editor (vi, nano, gedit, etc). Set the environment variable RTV_EDITOR to specify which editor the program should use.
$ export RTV_EDITOR=gedit
Usage
RTV currently supports browsing both subreddits and individual submissions. In each mode the controls are slightly different.
Global Commands
- ▲/▼ or j/k:
Scroll to the prev/next item
- a/z:
Upvote/downvote the selected item
- ENTER or o:
Open the selected item in the default web browser
- r:
Refresh the current page
- u:
Login and logout of your user account
- ?:
Show the help screen
- q:
Quit
Subreddit Mode
In subreddit mode you can browse through the top submissions on either the front page or a specific subreddit.
- ► or l:
View comments for the selected submission
- /:
Open a prompt to switch subreddits
- f:
Open a prompt to search the current subreddit
- p:
Post a new submission to the current subreddit
- e:
Edit the selected submission
- d:
Delete the selected submission
The / prompt accepts subreddits in the following formats
/r/python
/r/python/new
/r/python+linux supports multireddits
/r/front will redirect to the front page
/r/me will display your submissions
Submission Mode
In submission mode you can view the self text for a submission and browse comments.
- ◄ or h:
Return to subreddit mode
- ► or l:
Fold the selected comment, or load additional comments
- c:
Post a new comment on the selected item
- e:
Edit the selected comment
- d:
Delete the selected comment
Changelog
Please see CHANGELOG.rst.
Contributors
Please see CONTRIBUTORS.rst.
License
Please see LICENSE.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.