Install\r
-------\r
\r
-Prerequisite\r
-^^^^^^^^^^^^\r
-\r
-If you use Linux, you might need to install the ``python-dev`` and ``libsqlite3-dev`` packages if you haven't already. \r
-For debian-based distros, these can be installed with \r
-\r
-.. code:: bash\r
-\r
- sudo apt-get install python-dev libsqlite3-dev\r
-\r
-\r
-Besides, Mac OSX Maverick with Xcode 5.1 has a well-known `clang unknown argument`_ problem with \r
-the ``Pillow`` package installation - a dependency of this app.\r
-If you are in this case, I recommend take a look at `Issue #10`_ and let me know if the workaround doesn't work for you.\r
-\r
-\r
The quick way\r
^^^^^^^^^^^^^\r
\r
source venv/bin/activate\r
pip install rainbowstream\r
\r
+Troubleshooting\r
+^^^^^^^^^^^^^^^\r
+\r
+If you use Linux, you might need to install the python-dev package if you haven't already.\r
+For debian-based distros, these can be installed with\r
+\r
+.. code:: bash\r
+\r
+ sudo apt-get install python-dev\r
+\r
+Besides, Mac OSX Maverick with Xcode 5.1 has a well-known `clang unknown argument`_ problem with\r
+the ``Pillow`` package installation - a dependency of this app.\r
+If you are in this case, I recommend take a look at `Issue #10`_ and let me know if the workaround doesn't work for you.\r
\r
Usage\r
-----\r
\r
rainbowstream -iot # Or rainbowstream --image-on-term\r
\r
-You also can change the config key ``IMAGE_ON_TERM`` to ``True`` inside the app\r
-to enable above feature (see `config management`_ section).\r
+You also can change the config key ``IMAGE_ON_TERM`` to ``True`` inside the app \r
+to enable above feature, \r
+change ``IMAGE_SHIFT`` to set image's margin (relative to your terminal's width) \r
+or ``IMAGE_MAX_HEIGHT`` to control max height of every image.\r
+(see `config management`_ section).\r
\r
In the first time you will be asked for authorization of Rainbow Stream\r
app at Twitter. Just click the “Authorize access” button and paste PIN\r
\r
- ``q`` will quit.\r
\r
-Available commands are listed in `Read The Docs`_.\r
-\r
Theme customization\r
^^^^^^^^^^^^^^^^^^^\r
\r
Rainbow Stream has a config file located at ``~/.rainbow_config.json``.\r
You can view or set a new value of every config key by ``config`` command (See **Interactive mode** section above).\r
\r
+- ``HEARTBEAT_TIMEOUT``: after this timeout (count by minutes), the stream will automatically hangup.\r
+\r
+- ``IMAGE_ON_TERM``: display tweet's image directly on terminal.\r
+\r
- ``THEME``: current theme.\r
\r
- ``ASCII_ART``: diplay your twitter name by ascii art at stream begin or not.\r
\r
+- ``HIDE_PROMPT``: hide prompt after receiving a tweet or not.\r
+\r
+- ``PREFIX``: display string of prompt.\r
+\r
- ``SEARCH_MAX_RECORD``: max tweets can display on 'search' command.\r
\r
- ``HOME_TWEET_NUM``: default tweets to display on 'home' command.\r
+ ``#name``: Twitter's name\r
+ ``#nick``: Twitter's screen name\r
+ ``#clock``: Datetime\r
+ + ``#rt_count``: retweets count\r
+ + ``#fa_count``: favorites count\r
+ ``#id``: ID\r
+ ``#fav``: favorited symbol\r
+ + ``#fav``: favorited symbol\r
+ ``#tweet``: Tweet's content\r
+ ``#sender_name``: Message's sender name\r
+ ``#sender_nick``: Message's sender screen name\r