version
[rainbowstream.git] / docs / index.rst
index 0eea1d14a04a1c3c44b60d18316d6f6c2cc97c1d..8b4e1d8ddd8da22f116217a02a53920d365d8ddb 100644 (file)
@@ -10,7 +10,8 @@ Rainbow Stream
 Terminal-based Twitter Client. Realtime tweetstream, compose, search ,\r
 favorite … and much more fun directly from terminal.\r
 \r
 Terminal-based Twitter Client. Realtime tweetstream, compose, search ,\r
 favorite … and much more fun directly from terminal.\r
 \r
-This package is built on the top of `Python Twitter Tool`_ and `Twitter API`_.\r
+This package is built on the top of `Python Twitter Tool`_ and `Twitter API`_,\r
+can run on Python 2.7.x and 3.4.x .\r
 \r
 Install\r
 -------\r
 \r
 Install\r
 -------\r
@@ -159,6 +160,32 @@ Here is full list of supported command:
 \r
 -  ``report @dtvd88`` will report @dtvd88 as a spam account.\r
 \r
 \r
 -  ``report @dtvd88`` will report @dtvd88 as a spam account.\r
 \r
+**Twitter list**\r
+\r
+-  ``list`` will show all lists you are belong to.\r
+\r
+-  ``list home`` will show timeline of list. You will be asked for list's name.\r
+\r
+-  ``list all_mem`` will show list's all members.\r
+\r
+-  ``list all_sub`` will show list's all subscribers.\r
+\r
+-  ``list add`` will add specific person to a list owned by you.\r
+\r
+-  ``list rm`` will remove specific person from a list owned by you.\r
+\r
+-  ``list sub`` will subscribe you to a specific list.\r
+\r
+-  ``list unsub`` will unsubscribe you from a specific list.\r
+\r
+-  ``list own`` will show all list owned by you.\r
+\r
+-  ``list new`` will create a new list.\r
+\r
+-  ``list update`` will update a list owned by you.\r
+\r
+-  ``list del`` will delete a list owned by you.\r
+\r
 **Switching Stream Commands**\r
 \r
 -  ``switch public #AKB48`` will switch current stream to public stream\r
 **Switching Stream Commands**\r
 \r
 -  ``switch public #AKB48`` will switch current stream to public stream\r
@@ -187,11 +214,11 @@ Here is full list of supported command:
 \r
 **Screening Commands**\r
 \r
 \r
 **Screening Commands**\r
 \r
--  ``theme`` will list available themes. \r
-  \r
+-  ``theme`` will list available themes.\r
+\r
   + ``theme monokai`` will apply *monokai* theme immedaitely.\r
   + ``theme current_as_default`` will remember current theme as next time default.\r
   + ``theme monokai`` will apply *monokai* theme immedaitely.\r
   + ``theme current_as_default`` will remember current theme as next time default.\r
-  \r
+\r
 -  ``h`` will show the help.\r
 \r
 -  ``c`` will clear the screen.\r
 -  ``h`` will show the help.\r
 \r
 -  ``c`` will clear the screen.\r
@@ -230,7 +257,37 @@ Theme’s screenshot:
 \r
 For detaile information, see `theme usage and customization`_.\r
 \r
 \r
 For detaile information, see `theme usage and customization`_.\r
 \r
+Development\r
+-----------\r
+\r
+If you want to build a runnable version yourself, follow these simple\r
+steps\r
+\r
+-  `Create your own Twitter Application`_\r
+-  Get your Twitter application’s API key and secret\r
+-  Fork github's repo\r
+-  Create a file ``consumer.py`` in ```rainbowstream```_ folder with\r
+   following content\r
+\r
+   .. code:: python\r
+\r
+       # Consumer information\r
+       CONSUMER_KEY = 'APIKey' # Your Twitter application's API key\r
+       CONSUMER_SECRET = 'APISecret' # Your Twitter application's API secret\r
+\r
+-  Use pip to install in local\r
+\r
+   .. code:: bash\r
+\r
+       # cd to directory which contains setup.py\r
+       virtualenv venv # Python3 users: use -p to specify python3\r
+       source venv/bin/activate\r
+       pip install -e .\r
+       pip list | grep rainbowstream # confirm installed version\r
+       rainbowstream # local version of rainbowstream\r
 \r
 \r
+.. _Create your own Twitter Application: https://apps.twitter.com/app/new\r
+.. _``rainbowstream``: https://github.com/DTVD/rainbowstream/tree/master/rainbowstream\r
 .. _Python Twitter Tool: http://mike.verdone.ca/twitter/\r
 .. _Twitter API: https://dev.twitter.com/docs/api/1.1\r
 .. _theme usage and customization: https://github.com/DTVD/rainbowstream/blob/master/theme.md\r
 .. _Python Twitter Tool: http://mike.verdone.ca/twitter/\r
 .. _Twitter API: https://dev.twitter.com/docs/api/1.1\r
 .. _theme usage and customization: https://github.com/DTVD/rainbowstream/blob/master/theme.md\r