Reddithor

Stay updated with a subreddit of your choice.


Keywords
reddit, Reddithor, subreddit, Linux
License
Apache-2.0
Install
pip install Reddithor==0.0.5

Documentation

Reddithor

Reddithor - a fork of HackerTray - allows you to browse the posts from subreddit of your choice from within the tray of your Linux OS. Reddithor automatically updates every 2 minutes in the background. As mentioned in the readme of HackerTray, this application relies on appindicator, and is not guaranteed to run on every computer.

Screenshot

Reddithor Screenshot on Ubuntu

Installation

Reddithor is distributed as a python package. Do the following to install:

sudo pip install Reddithor
OR
#Download Source and cd into it
sudo python setup.py install

You can now run Reddithor from anywhere. You can also add it to your OS dependent session autostart method. In Ubuntu, you can access this via:

  1. System > Preferences > Sessions
    (OR)
  2. System > Preferences > Startup Applications

depending on your Ubuntu Version. Or alternatively, you may put it in ~/.config/openbox/autostart.

Upgrade

The latest stable version is the one on PyPi

You can check which version you have installed with Reddithor --version.

To upgrade, run pip install -U Reddithor. In some cases (Ubuntu), you might need to clear the pip cache before upgrading:

sudo rm -rf /tmp/pip-build-root/Reddithor

Reddithor will automatically check the latest version on startup, and inform you if there is an update available.

Options

-c: Enables comments support. Clicking on links will also open the comments page on Reddit.

Features

  1. Stay up-to-date on Reddit without the distraction of opening Reddit itself.
  2. Opens links in your default browser
  3. Remembers which links you opened
  4. Shows Points/Comment count
  5. Allows you to choose a subreddit that you want to keep a tab on

Troubleshooting

If the app indicator fails to show in Ubuntu versions, consider installing python-appindicator with

sudo apt-get install python-appindicator

TODO:

  • Write unit tests
  • Make a command line executable

Development

To develop on Reddithor, or to test out experimental versions, do the following:

  • Clone the project
  • Run (sudo) python setup.py develop in the Reddithor root directory
  • Run Reddithor with the required command line options from anywhere.

Credits

Author Information

Licence

Copyright 2016 Murtaza Akbari

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.