a7b789bfd9
Updated the supported python versions list.
Fixed regression in displaying xposts. #173.
Fixing a few style things.
Added a more robust test for the tornado handler.
Trying without pytest-cov
Updated travis for coverage.
Remove python 3.2 support because no unicode literals, following what praw supports.
"Side effect is not iterable."
Added requirements for travis.
Renamed travis file correctly.
Adding test configurations, got tox working.
Adding vcr cassettes to the repo.
Renamed requirements files.
Split up tests and cleaned up test names.
Tests done, still one failure.
Treat cassettes as binary to prevent bad merging.
Fixed a few broken tests.
Added a timeout to notifications.
Prepping subreddit page.
Finished submission page tests.
Working on submission tests.
Fixed vcr matching on urls with params, started submission tests.
Log cleanup.
Still trying to fix a broken test.
-Fixed a few pytest bugs and tweaked logging.
Still working on subscription tests.
Finished page tests, on to subscription page.
Finished content tests and starting page tests.
Added the test refresh-token file to gitignore.
Moved functional test file out of the repository.
Continuing work on subreddit content tests.
Tests now match module names, cassettes are split into individual tests for faster loading.
Linter fixes.
Cleanup.
Added support for nested loaders.
Added pytest options, starting subreddit content tests.
Back on track with loader, continuing content tests.
Finishing submission content tests and discovered snag with loader exception handling.
VCR up and running, continuing to implement content tests.
Playing around with vcr.py
Moved helper functions into terminal and new objects.py
Fixed a few broken tests.
Working on navigator tests.
Reorganizing some things.
Mocked webbrowser._tryorder for terminal test.
Completed oauth tests.
Progress on the oauth tests.
Working on adding fake tornado request.
Starting on OAuth tool tests.
Finished curses helpers tests.
Still working on curses helpers tests.
Almost finished with tests on curses helpers.
Adding tests and working on mocking stdscr.
Starting to add tests for curses functions.
Merge branch 'future_work' of https://github.com/michael-lazar/rtv into future_work
Refactoring controller, still in progress.
Renamed auth handler.
Rename CursesHelper to CursesBase.
Added temporary file with a possible template for func testing.
Mixup between basename and dirname.
Merge branch 'future_work' of https://github.com/michael-lazar/rtv into future_work
py3 compatability for mock.
Beginning to refactor the curses session.
Started adding tests, improved unicode handling in the config.
Cleanup, fixed a few typos.
Major refactor, almost done!.
Started a config class.
Merge branch 'master' into future_work
The editor now handles unicode characters in all situations.
Fixed a few typos from previous commits.
__main__.py formatting.
Cleaned up history logic and moved to the config file.
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 rtvOr clone the repository
$ git clone https://github.com/michael-lazar/rtv.git
$ cd rtv
$ sudo python3 setup.py installThe installation will place a script in the system path
$ rtv
$ rtv --helpSee the FAQ for more information on common installation problems
Usage
RTV supports browsing both subreddits and submission comments.
Navigating is simple and intuitive. Move the cursor using either the arrow keys or Vim style movement. Move up and down to scroll through the page. Move right to view the selected submission, and left to exit the submission.
Basic Commands
- j/k or ▲/▼:
Move the cursor up/down
- m/n or PgUp/PgDn:
Jump to the previous/next page
- 1-5:
Toggle post order (hot, top, rising, new, controversial)
- r or F5:
Refresh page content
- u:
Log in or switch accounts
- ?:
Show the help screen
- q/Q:
Quit/Force quit
Authenticated Commands
Some actions require that you be logged in to your reddit account. You can log in by pressing u while inside of the program. Once you are logged in your username will appear in the top-right corner of the screen.
- a/z:
Upvote/downvote
- c:
Compose a new post or comment
- e:
Edit an existing post or comment
- d:
Delete an existing post or comment
- i:
Display new messages prompt
- s:
View a list of subscribed subreddits
Subreddit Mode
In subreddit mode you can browse through the top submissions on either the front page or a specific subreddit.
- l or ►:
Enter the selected submission
- o or ENTER:
Open the submission link with your web browser
- /:
Open a prompt to switch subreddits
- f:
Open a prompt to search the current subreddit
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.
- h or ◄:
Return to the subreddit
- o or ENTER:
Open the comment permalink with your web browser
- SPACE:
Fold the selected comment, or load additional comments
Configuration
Editor
RTV allows users to compose comments and replies using their preferred text editor (vi, nano, gedit, etc). You can specify which text editor you would like to use by setting the $RTV_EDITOR environment variable.
$ export RTV_EDITOR=geditIf no editor is specified, RTV will fallback to the system's default $EDITOR, and finally to nano.
Web Browser
RTV has the capability to open links inside of your web browser. By default RTV will use the system's browser. On most systems this corresponds to a graphical browser such as Firefox or Chrome. If you prefer to stay in the terminal, use $BROWSER to specify a console-based web browser. w3m, lynx, and elinks are all good choices.
$ export BROWSER=w3mAuthentication
RTV uses OAuth to facilitate logging into your reddit user account [1]. The login process follows these steps:
You initiate a login by pressing the u key.
You're redirected to a webbrowser where reddit will ask you to login and authorize RTV.
RTV uses the generated token to login on your behalf.
The token is stored on your computer at ~/.config/rtv/refresh-token for future sessions. You can disable this behavior by setting persistent=False in your RTV config.
Note that RTV no longer allows you to input your username/password directly. This method of cookie based authentication has been deprecated by reddit and will not be supported in future releases [2].
Config File
RTV will read a configuration placed at ~/.config/rtv/rtv.cfg (or $XDG_CONFIG_HOME). Each line in the file will replace the corresponding default argument in the launch script. This can be used to avoid having to re-enter login credentials every time the program is launched.
Example initial config:
rtv.cfg
[rtv]
# 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
# Turn on ascii-only mode and disable all unicode characters
# This may be necessary for compatibility with some terminal browsers
# ascii=True
# Enable persistent storage of your authentication token
# This allows you to remain logged in when you restart the program
persistent=TrueFAQ
- Why am I getting an error during installation/when launching rtv?
If your distro ships with an older version of python 2.7 or python-requests, you may experience SSL errors or other package incompatibilities. The easiest way to fix this is to install rtv using python 3. If you don't already have pip3, see http://stackoverflow.com/a/6587528 for setup instructions. Then do
$ sudo pip uninstall rtv $ sudo pip3 install -U rtv- How do I run the repository code directly?
This project is structured to be run as a python module. This means that in order to resolve imports you need to launch using python's -m flag. This method works for all versions of python. See the example below, which assumes that you have cloned the repository into the directory ~/rtv_project.
$ cd ~/rtv_project $ python3 -m pip install -r requirements.py3.txt $ python3 -m rtv
Changelog
Please see CHANGELOG.rst.
Contributors
Please see CONTRIBUTORS.rst.
License
Please see LICENSE.