============================ RTV (Reddit Terminal Viewer) ============================ | RTV provides an interface to view and interact with reddit from your terminal. | It's compatible with *most* terminal emulators on Linux and OS X. .. image:: http://i.imgur.com/Ek13lqM.png | | RTV is built in **python** using the **curses** library. --------------- |pypi| |python| |travis-ci| |coveralls| |gitter| --------------- * `Installation`_ * `Usage`_ * `Settings`_ * `FAQ`_ * `Contributing`_ * `License`_ ============ Installation ============ Install using pip (**recommended**) .. code-block:: bash $ pip install rtv or clone the repository .. code-block:: bash $ git clone https://github.com/michael-lazar/rtv.git $ cd rtv $ python3 setup.py install on Arch Linux or Arch based distros (Antergos, Manjaro, `etc.`_) you can install directly with an `aur helper`_ such as yaourt. .. code:: bash $ yaourt -S rtv $ # or to keep up to date with the master branch $ yaourt -S rtv-git .. _etc.: https://wiki.archlinux.org/index.php/Arch_based_distributions_(active) .. _aur helper: https://wiki.archlinux.org/index.php/AUR_helpers#AUR_search.2Fbuild_helpers ===== Usage ===== To run the program, type .. code-block:: bash $ rtv --help -------- Controls -------- Move the cursor using either 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 ``space`` to expand/collapse comments - Press ``u`` to login - Press ``?`` to open the help screen Press ``/`` to open the navigation prompt, where you can type things like - /front - /r/commandprompt+linuxmasterrace - /r/programming/controversial-week - /u/me - /u/multi-mod/m/art - /domain/github.com See `CONTROLS `_ for the full list of commands. ======== Settings ======== ------------- Configuration ------------- Configuration settings are stored in ``{HOME}/.config/rtv/rtv.cfg``. Auto-generate the config file by running .. code-block:: bash $ rtv --copy-config See the `default config `_ for the full list of settings. ------ Editor ------ You can compose posts and reply to comments using your preferred text editor. Set the editor by changing ``$RTV_EDITOR`` in your environment. .. code-block:: bash $ export RTV_EDITOR=gedit If not specified, the default system ``$EDITOR`` (or *nano*) will be used. ----------- Web Browser ----------- You can open submission links using your web browser. On most systems the default web browser will open in a new window. If you prefer the complete terminal experience, set ``$BROWSER`` to a console-based web browser. .. code-block:: bash $ export BROWSER=w3m `w3m `_, `lynx `_, and `elinks `_ are all good choices. ---------- Url Viewer ---------- You can extract links from inside of comments using urlview. Use ``$RTV_URLVIEWER`` to specify a custom url viewer. .. code-block:: bash $ export RTV_URLVIEWER=urlview `urlview `_ and `urlscan `_ are known to be compatible, but any program that accepts text via a stdin pipe will do. These applications don't come pre-installed, but are available through most systems' package managers. === FAQ === 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 .. code-block:: bash $ 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**. .. code-block:: bash $ cd ~/rtv_project $ python3 -m rtv ============ Contributing ============ All feedback and suggestions are welcome, just post an issue! Before writing any code, please read the `Contributor Guidelines `_. ======= License ======= This project is distributed under the `MIT `_ license. .. |python| image:: https://img.shields.io/badge/python-2.7%2C%203.5-blue.svg :target: https://pypi.python.org/pypi/rtv/ :alt: Supported Python versions .. |pypi| image:: https://img.shields.io/pypi/v/rtv.svg?label=version :target: https://pypi.python.org/pypi/rtv/ :alt: Latest Version .. |travis-ci| image:: https://travis-ci.org/michael-lazar/rtv.svg?branch=master :target: https://travis-ci.org/michael-lazar/rtv :alt: Build .. |coveralls| image:: https://coveralls.io/repos/michael-lazar/rtv/badge.svg?branch=master&service=github :target: https://coveralls.io/github/michael-lazar/rtv?branch=master :alt: Coverage .. |gitter| image:: https://img.shields.io/gitter/room/michael-lazar/rtv.js.svg :target: https://gitter.im/michael-lazar/rtv :alt: Chat