Introduction

Rainbow Stream allows you to manage just about every aspect of your Twitter account from the command line. Yes, you did read that right. It's a full featured command line Twitter client written in Python. Chances are, you're falling into one of two camps right about now. If you're in the slightly insane one that thinks this is a good idea, stay tuned. Rainbow Stream actually does provide an simple and intuitive Twitter experience from the Linux command line.

Prerequisite Packages

You probably have everything that you need to get Rainbow Stream working on your system right now, but just to be sure, there are a few packages that you should install if you haven't already. Debian Distros

# apt-get install python-dev libjpeg libjpeg-dev libfreetype6 libfreetype6-dev zlib1g-dev virtualenv

Redhat Distros

# dnf/yum install python libjpeg freetype freetype1 zlib python-virtualenv

Set Up The Virtualenv

So, you don't exactly need Virtualenv, but Rainbow Stream pulls in a lot of dependencies, and since you're going to need to manage it with Pip, you probably need want to compartmentalize it into its own virtual environment.

Figure out where you want your Twitter environment, and create your virtual environment.

$ virtualenv -p python3 twitter

Now, cd in to your new twitter folder, and activate the environment.

$ cd twitter
$ source bin/activate

That's it. You're ready to install.

Install Rainbow Stream

Pip is the best way to manage Rainbow Stream, since it's a Python package that isn't packaged by many, if any, major distributions at the time of this guide. That's alright, though. Installing it with Pip is very easy.

pip install rainbowstream

Pip will run through a relatively lengthy installation process to pull in Rainbow Stream and all of its dependencies.

Basic Usage

First Run

You will always need to be in your virtual environment with it activated to run Rainbow Stream. Once you're there, you can start it up like any other CLI application.

$ rainbowstream

On your first run, Rainbow Stream is going to ask you to grant it permission to access your Twitter account. It will automatically open up a web browser on your computer to the Twitter page needed to grant external applications permission to access your account. Fill out your Twitter username and password, and confirm Rainbow Stream's access.

After your successful confirmation, the terminal window will display your Twitter handle in ASCII art and log you in.

Setting Your Stream

By default, Rainbow Stream will populate with new tweets from your stream as they arrive. You don't need to do anything extra in order to see incoming tweets, and you don't need to refresh.

Rainbow Stream does eventually timeout if you haven't been active for a while. When this happens, you have to reactivate your stream. You can do this by typing in the following.

stream mine

Getting Recent Tweets

If you've just signed on, and you want to see past tweets from when you were away, you can use Rainbow Stream's home command to collect a specific number of past tweets.

home 10

Opening a Tweet

Rainbow Stream assigns every tweet that comes in an ID. These IDs are unique to the session, but do reset. It doesn't really matter, though. They're just for interacting with tweets as they come in or right after they were pulled. To open up a tweet or the link from it, use the built in command.

open id#

Just include the number in place of #id.

Tweeting

Tweeting from Rainbow Stream is very simple. Just add the letter t before the text you want to tweet out.

t Rainbow Stream is awesome! #cliftw

Retweeting

Retweeting from Rainbow Stream uses its ID system. Type rt followed by the ID number of the post that you would like to retweet.

rt 15

Following

You can probably see a pattern developing here. Like most other CLI programs, everything is done with simple commands that have parameters. The same is true for following someone.

fl @linuxconfig

Favorite

To favorite a tweet, use fav and the tweet ID.

fav 15

Quoting

Quoting is just like the other ID based commands.

quote 15

Trends

If you want to see what is trending globally, just type trend. If you want the trends for your country, add the two letter country code.

trend US

Themes

Rainbow Stream has multiple available themes that change the color scheme of posts in your stream. To list out the themes, type theme. To set the theme, add the name of the theme.

theme tomorrow_night

Config

Rainbow Stream has a fairly simple configuration system. To see the available options, type config. You will see a list of the available options and their current values. To change one, type config again followed by the item that you'd like to change set equal to the new value.

config IMAGE_ON_THERM = True

The above command will cause the images associated with the tweets in your feed to appear in the terminal... extremely pixelated.

Getting More Help

There's a lot more that Rainbow Stream can do. Unfortunately, it'd take way too long to go over it all in a single guide. However, the Rainbow Stream developers have built an awesome help system into their Twitter client. To see a help overview, type h. This will give you a general picture of the help categories that are available. To get more specific help, type h followed by the category that you're looking for.

h tweets

You can use this method as a quick reference whenever you need.

If you're looking for even more depth, you can always check out the http://www.rainbowstream.org/ Rainbow Stream website.

Closing Thoughts

If you're the type of person that absolutely loves the command line, and wants a Twitter client to fit your minimalist computing style, Rainbow Stream is just the thing for you. It's actually very simple and intuitive once you get used to its system, and even if you forget, the help system is great. Rainbow Stream also makes an excellent compliment to tiling window managers, so if you're a fan of those, you should definitely give it a shot as well.