X-Git-Url: https://vcs.fsf.org/?a=blobdiff_plain;ds=sidebyside;f=README.rst;h=ee15eb5bfd4a1bd5effc77d4050b4e93189a7705;hb=22592b9a295c8f96ec2305bb0dccab05aeed92aa;hp=de88ab0220f6e5649f79b070a533dbc35f319c05;hpb=b913cd7528810f85f31608f784cba4bfb9477e56;p=rainbowstream.git

diff --git a/README.rst b/README.rst
index de88ab0..ee15eb5 100644
--- a/README.rst
+++ b/README.rst
@@ -16,32 +16,35 @@ Showcase
 ----------
 Screencast: https://www.youtube.com/watch?v=tykCvPMJq8s
 
-Screenshot:
-
-.. figure:: https://raw.githubusercontent.com/DTVD/rainbowstream/master/screenshot/RainbowStream.png
-   :alt: rainbowstream
-
-.. figure:: https://raw.githubusercontent.com/DTVD/rainbowstream/master/screenshot/RainbowStreamIOT.png
-   :alt: rainbowstreamIOT
 
 Install
 -------
 
-You will need Python 2.7+ and pip.
+The quick way
+^^^^^^^^^^^^^
+
+You will need Python and pip (2.7.x or 3.x).
 
 .. code:: bash
 
     sudo pip install rainbowstream
+    # Python 3 users: sudo pip3 install rainbowstream
+
 
-or try with a virtualenv
+The recommended way
+^^^^^^^^^^^^^^^^^^^
+
+Use `virtualenv`_
 
 .. code:: bash
 
-    sudo pip install virtualenv # skip if you already have virtualenv
     virtualenv venv
-    source venv/bin/activate # use the brand new virtualenv.
+    # Python 3 users : use -p to specify your Python 3 localtion as below
+    # virtualenv -p /usr/bin/python3 venv
+    source venv/bin/activate
     pip install rainbowstream
 
+
 Usage
 -----
 
@@ -52,7 +55,7 @@ Just type
 
 .. code:: bash
 
-    rainbow
+    rainbowstream
 
 and see your stream.
 
@@ -61,7 +64,7 @@ You can try it with:
 
 .. code:: bash
 
-    rainbow -iot # Or rainbow --image-on-term
+    rainbowstream -iot # Or rainbowstream --image-on-term
 
 In the first time you will be asked for authorization of Rainbow Stream
 app at Twitter. Just click the “Authorize access” button and paste PIN
@@ -83,9 +86,32 @@ Available commands are listed in `Read The Docs`_.
 Theme customization
 ------------------------
 
-Rainbow Stream is shipped with some default themes. 
+Rainbow Stream is shipped with some default themes.
 You can either change theme by ``theme`` command or create your favorite one.
 
+Theme’s screenshot:
+
+- Monokai
+
+.. figure:: https://raw.githubusercontent.com/DTVD/rainbowstream/master/screenshot/themes/Monokai.png
+   :alt: monokai
+
+- Solarized
+
+.. figure:: https://raw.githubusercontent.com/DTVD/rainbowstream/master/screenshot/themes/Solarized.png
+   :alt: solarized
+
+- Tomorrow Night
+
+.. figure:: https://raw.githubusercontent.com/DTVD/rainbowstream/master/screenshot/themes/TomorrowNight.png
+   :alt: tomorrownight
+
+- Larapaste
+
+.. figure:: https://raw.githubusercontent.com/DTVD/rainbowstream/master/screenshot/themes/larapaste.png
+   :alt: larapaste
+
+
 For detaile information, see `theme usage and customization`_.
 
 Bug and feature requests
@@ -94,6 +120,36 @@ Bug and feature requests
 Found a bug or a feature request ?
 Please `create an issue`_ or contact me at `@dtvd88`_
 
+Development
+-----------
+
+If 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 secret
+-  Fork github's repo
+-  Create a file ``consumer.py`` in ```rainbowstream```_ folder with
+   following content
+
+   .. code:: python
+
+       # Consumer information
+       CONSUMER_KEY = 'APIKey' # Your Twitter application's API key
+       CONSUMER_SECRET = 'APISecret' # Your Twitter application's API secret
+
+-  Use pip to install in local
+
+   .. code:: bash
+
+       # cd to directory which contains setup.py
+       virtualenv venv # Python3 users: use -p to specify python3
+       source venv/bin/activate
+       pip install -e .
+       pip list | grep rainbowstream # confirm installed version
+       rainbowstream # local version of rainbowstream
+
+
 Contributing
 ------------
 I appreciate any help and support. Feel free to `fork`_ and `create a pull request`_.
@@ -115,3 +171,6 @@ details
 .. _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
+.. _``rainbowstream``: https://github.com/DTVD/rainbowstream/tree/master/rainbowstream
+.. _virtualenv: http://docs.python-guide.org/en/latest/dev/virtualenvs/