Package: rainbowstream
A Note about Twitter API ChangeHeads-up! As Twitterdiscontinues supportingStream API, RainbowStream's stream function has been stopped working for a long time. But here is a good new, from version 1.5.0 weswitched to a Polling Strategythat using thehomecommand to check for every 90 seconds. Notes that rate limit forhomecommand itself is 15 times per 15 minutes, so don't abuse it too much to leave space for the polling stream :)If you are interested in detail:https://github.com/orakaro/rainbowstream/issues/271Rainbow Stream.. image::http://img.shields.io/pypi/l/rainbowstream.svg?style=flat-square:target:https://github.com/DTVD/rainbowstream/blob/master/LICENSE.txt.. image::http://img.shields.io/pypi/v/rainbowstream.svg?style=flat-square:target:https://pypi.python.org/pypi/rainbowstreamTerminal-based Twitter Client.  Real-time tweetstream, compose, search, favorite,
and much more fun directly from terminal.This package is built on thePython Twitter Tools_ and theTwitter API_, and runs
on Python (2.7.x and 3.x).Home page:https://github.com/orakaro/rainbowstreamSource code:https://github.com/orakaro/rainbowstreamShowcase.. figure::https://raw.githubusercontent.com/DTVD/rainbowstream/master/screenshot/rs.gif:alt: gifInstallationThe Quick Way
^^^^^^^^^^^^^System Python (2.7.x or 3.x).. code:: bashsudo pip install rainbowstream
# Python 3 users: sudo pip3 install rainbowstreamThe Recommended Way
^^^^^^^^^^^^^^^^^^^virtualenv_.. code:: bashvirtualenv venv
# Python 3 users : use -p to specify your Python 3 location:
# virtualenv -p /usr/bin/python3 venv
source venv/bin/activate
pip install rainbowstreamTroubleshooting
^^^^^^^^^^^^^^^Some additional libraries may need to be installed on linux.For Debian-based distros:.. code:: bashsudo apt-get install python-dev libjpeg-dev libfreetype6 libfreetype6-dev zlib1g-devFor CentOS:.. code:: bashsudo yum install python-devel libjpeg-develMac OSX Maverick with Xcode 5.1 has a well-knownclang unknown argument_
problem with the installation of thePillowpackage—a dependency of this
app.  Take a look atIssue #10_ and let me know if the workaround doesn't work
for you... code:: bashexport ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-futureIfThe Quick Waydoesn't work, then:sudo pip uninstall rainbowstreamUse theThe Recommended WayCreate an issue_ and provide:Your OSYour Python versionUsageThe Stream
^^^^^^^^^^Just typerainbowstreamto see your stream.You can nowdisplay tweeted images directly on the terminal!  Try it with:.. code:: bashrainbowstream -iot # Or rainbowstream --image-on-termSetIMAGE_ON_TERMtoTruein your config to to enable above feature,
changeIMAGE_SHIFTto set image's margin (relative to your terminal's
width), andIMAGE_MAX_HEIGHTto control max height of every image (seeConfig Management_).You will be asked for authorization on Twitter the first time you run Rainbow
Stream.  Just click the "Authorize access" button, paste PIN number to the
terminal, and the rainbow will start.You might want to use Rainbow Stream with anHTTP/SOCKS proxy.  Proxy
settings are specified as follows:.. code:: bashrainbowstream --proxy-host localhost --proxy-port 1337 --proxy-type HTTP
# or the short form:
rainbowstream -ph localhost -pp 1337 -pt HTTPBoth--proxy-portand--proxy-typeare optional.  The default proxy port
is8080and the default proxy type isSOCKS5.Interactive Mode
^^^^^^^^^^^^^^^^While your personal stream is continued, you are also ready to tweet, search,
reply, retweet, etc. directly from your console.  Simply typehand hit the
Enter key to see the help.Input is in interactive mode.  It means that you can use the arrow keys to move
up and down through the history, tab-autocomplete or double-tab to view
available suggestions.  Input history from previous run is also available.Read the docs_ for available commands.Theme Customization
^^^^^^^^^^^^^^^^^^^Rainbow Stream is shipped with some default themes.  You can switch themes with
thethemecommand.  You can also customize themes as you please.Theme screenshots:Monokai.. figure::https://raw.githubusercontent.com/DTVD/rainbowstream/master/screenshot/themes/Monokai.png:alt: monokaiSolarized.. figure::https://raw.githubusercontent.com/DTVD/rainbowstream/master/screenshot/themes/Solarized.png:alt: solarizedTomorrow Night.. figure::https://raw.githubusercontent.com/DTVD/rainbowstream/master/screenshot/themes/TomorrowNight.png:alt: tomorrownightLarapaste.. figure::https://raw.githubusercontent.com/DTVD/rainbowstream/master/screenshot/themes/larapaste.png:alt: larapasteSeeTheme Usage and Customization_ for detailed information.Bug and Feature RequestsFound a bug or a feature request?  Pleasecreate an issue_ or contact me at@dtvd88_.DevelopmentIf you want to build a runnable version yourself, follow these simple steps:Create your own Twitter Application_Get your Twitter application’s API key and secretCreate your own Pocket Application_ (platform: Web)Get your Pocket application’s keyFork this repo andgit cloneitCreate aconsumer.pyfile in therainbowstream_ directory containing:.. code:: python# Consumer information
CONSUMER_KEY = 'APIKey' # Your Twitter application's API key
CONSUMER_SECRET = 'APISecret' # Your Twitter application's API secret
PCKT_CONSUMER_KEY = 'PocketAPIKey' # Your Pocket application's API keyUse pip to install it locally.. code:: bash# cd to directory which contains setup.py (cloned directory)
virtualenv venv # Python3 users: use -p to specify python3
source venv/bin/activate
pip install -e .
which rainbowstream # /this-directory/venv/bin/rainbowstream
# Remove ~/.rainbow_oauth if it exists
rainbowstream # local version of rainbowstreamContributingI appreciate any help and support.  Feel free tofork_ andcreate a pull request_.  You will be listed as a contributor.LicenseRainbow Stream is released under an MIT License.  See LICENSE.txt for details... _Python Twitter Tools:http://mike.verdone.ca/twitter/.. _Twitter API:https://dev.twitter.com/docs/api/1.1.. _Create an issue:https://github.com/DTVD/rainbowstream/issues/new.. _@dtvd88:https://twitter.com/dtvd88.. _fork:https://github.com/DTVD/rainbowstream/fork.. _create a pull request:https://github.com/DTVD/rainbowstream/compare/.. _Read the docs:http://rainbowstream.readthedocs.org/en/latest/.. _config guide:https://github.com/DTVD/rainbowstream/blob/master/theme.md.. _Theme Usage and Customization:https://github.com/DTVD/rainbowstream/blob/master/theme.md.. _Create your own Twitter Application:https://apps.twitter.com/app/new.. _Create your own Pocket Application:https://getpocket.com/developer/apps/new.. _rainbowstream:https://github.com/DTVD/rainbowstream/tree/master/rainbowstream.. _virtualenv:http://docs.python-guide.org/en/latest/dev/virtualenvs/.. _Config Management:http://rainbowstream.readthedocs.org/en/latest/#config-explanation.. _clang unknown argument:http://kaspermunck.github.io/2014/03/fixing-clang-error/.. _Issue #10:https://github.com/DTVD/rainbowstream/issues/10