Rainbow Stream\r
--------------\r
\r
-.. image:: http://img.shields.io/pypi/dm/rainbowstream.svg?style=flat\r
- :target: https://pypi.python.org/pypi/rainbowstream\r
+.. image:: http://img.shields.io/pypi/l/rainbowstream.svg?style=flat-square\r
+ :target: https://github.com/DTVD/rainbowstream/blob/master/LICENSE.txt\r
\r
-.. image:: http://img.shields.io/pypi/v/rainbowstream.svg?style=flat\r
+.. image:: http://img.shields.io/pypi/v/rainbowstream.svg?style=flat-square\r
:target: https://pypi.python.org/pypi/rainbowstream\r
\r
Terminal-based Twitter Client. Realtime tweetstream, compose, search ,\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.x .\r
\r
+Home page : http://www.rainbowstream.org/\r
+\r
+Source code : https://github.com/DTVD/rainbowstream\r
+\r
Install\r
-------\r
\r
app at Twitter. Just click the “Authorize access” button and paste PIN\r
number to the terminal, the rainbow will start.\r
\r
+You might want to use rainbowstream via an **HTTP/SOCKS proxy**. Proxy settings are\r
+provided as follows:\r
+\r
+.. code:: bash\r
+\r
+ rainbowstream --proxy-host localhost --proxy-port 1337 --proxy-type HTTP\r
+ # or using the short form:\r
+ rainbowstream -ph localhost -pp 1337 -pt HTTP\r
+\r
+Both ``--proxy-port`` and ``--proxy-type`` can be omitted. In this case default\r
+proxy port ``8080`` and default proxy type ``SOCKS5`` are used.\r
+\r
The interactive mode\r
^^^^^^^^^^^^^^^^^^^^\r
\r
\r
**Explore Commands**\r
\r
-- ``trend`` will show global trending topics. ``trend US`` will show\r
- trends in United States while ``trend JP Tokyo`` will show trends in\r
- Tokyo/Japan.\r
+- ``trend`` will show global trending topics. ``trend US`` will show trends in United States while ``trend JP Tokyo`` will show trends in Tokyo/Japan.\r
+\r
+- ``home`` will show your timeline. ``home 10`` will print exactly 10 tweets.\r
\r
-- ``home`` will show your timeline. ``home 10`` will print exactly 10\r
- tweets.\r
+- ``notification`` will show your notification from the time you started RainbowStream.\r
\r
-- ``mentions`` will show mentions timeline. ``mentions 7`` will show 7\r
- mention tweets.\r
+- ``mentions`` will show mentions timeline. ``mentions 7`` will show 7 mention tweets.\r
\r
- ``whois @dtvd88`` will show profile of @dtvd88.\r
\r
-- ``view @mdo`` will show @mdo ’s timeline. ``view @dmo 9`` will print\r
- exactly 9 tweets.\r
+- ``view @mdo`` will show @mdo ’s timeline. ``view @dmo 9`` will print exactly 9 tweets.\r
\r
-- ``s noah`` will search the word *‘noah’*. Result will come back with\r
- highlight. Search can be performed with or without hashtag.\r
+- ``s noah`` will search the word *‘noah’*. Result will come back with highlight. Search can be performed with or without hashtag.\r
\r
**Tweet Commands**\r
\r
-- ``t the rainbow is god's promise to noah`` will tweet exactly *‘the\r
- rainbow is god’s promise to noah’*.\r
+- ``t the rainbow is god's promise to noah`` will tweet exactly *‘the rainbow is god’s promise to noah’*.\r
\r
-- ``rt 12`` will retweet the tweet with *[id=12]*. You can see id of\r
- each tweet beside the time.\r
+- ``rt 12`` will retweet the tweet with *[id=12]*. You can see id of each tweet beside the time.\r
\r
-- ``quote 12`` will quote the tweet with *[id=12]*. If no extra text is added,\r
- the quote will be cancelled.\r
+- ``quote 12`` will quote the tweet with *[id=12]*. If no extra text is added, the quote will be cancelled.\r
\r
- ``allrt 12 20`` will list 20 newest retweets of the tweet with *[id=12]*. If the number of retweets is not specified, 5 newest retweets will be listed instead.\r
\r
- ``conversation 12`` will show the chain of replies prior to the tweet with *[id=12]*.\r
\r
-- ``rep 12 Really`` will reply *‘Really’* to the tweet with *[id=12]*.\r
+- ``rep 12 Really`` will reply *‘Really’* to the owner of the tweet with *[id=12]*.\r
+\r
+- ``repall 12 Really`` will reply *‘Really’* to all people in the tweet with *[id=12]*.\r
\r
- ``fav 12`` will favorite the tweet with *[id=12]*.\r
\r
- ``ufav 12`` will unfavorite tweet with *[id=12]*.\r
\r
+- ``share 12`` will copy link to tweet with *[id=12]* to your clipboard if you are on a Mac, or display it directly if you are on Linux.\r
+\r
- ``del 12`` will delete tweet with *[id=12]*.\r
\r
-- ``show image 12`` will show the image in tweet with *[id=12]* in your\r
- OS’s image viewer.\r
+- ``show image 12`` will show the image in tweet with *[id=12]* in your OS’s image viewer.\r
+\r
+- ``open 12`` will open url in tweet with *[id=12]* in your OS’s default browser.\r
\r
-- ``open 12`` will open url in tweet with *[id=12]* in your\r
- OS’s default browser.\r
+- ``pt 12`` will add tweet with *[id=12]* in your Pocket list.\r
\r
**Direct Messages Commands**\r
\r
\r
**Friends and followers Commands**\r
\r
-- ``ls fl`` will list all your followers (people who are following\r
- you).\r
+- ``ls fl`` will list all your followers (people who are following you).\r
\r
- ``ls fr`` will list all your friends (people who you are following).\r
\r
\r
**Switching Stream Commands**\r
\r
-- ``switch public #AKB48`` will switch current stream to public stream\r
- and track keyword ``AKB48``\r
+- ``switch public #AKB48`` will switch current stream to public stream and track keyword ``AKB48``\r
\r
-- ``switch public #AKB48 -f`` will do exactly as above but will ask you\r
- to provide 2 list:\r
+- ``switch public #AKB48 -f`` will do exactly as above but will ask you to provide 2 list:\r
\r
``Only nicks`` decide what nicks will be include only.\r
\r
``Ignore nicks``\ decide what nicks will be exclude.\r
\r
-- ``switch public #AKB48 -d`` will apply filter to *ONLY\_LIST* and\r
- *IGNORE\_LIST*. You can setup 2 list above at ``config.py``\r
+- ``switch mine`` will switch current stream to personal stream. ``-f`` will work as well.\r
\r
-- ``switch mine`` will switch current stream to personal stream. ``-f``\r
- and ``-d`` will work as well.\r
+- ``switch list`` will switch to a Twitter list's stream. You will be asked for list name.\r
\r
**Smart shell**\r
\r
\r
- ``c`` will clear the screen.\r
\r
+- ``v`` will show version info.\r
+\r
- ``q`` will quit.\r
\r
Theme customization\r
\r
- ``HIDE_PROMPT``: hide prompt after receiving a tweet or not.\r
\r
-- ``PREFIX``: display string of prompt.\r
+- ``PREFIX``: display formated string of prompt.\r
+\r
+ + ``#me``: Your username with '@', only available in personal stream.\r
+ + ``#place``: List name, only available in list stream.\r
+ + ``#owner``: Owner of list name, only available in list stream.\r
+ + ``#keyword``: Keyword, only available on public stream.\r
\r
- ``SEARCH_TYPE``: search type in 'search' command ('mixed','recent','popular').\r
\r
\r
- ``THREAD_MIN_WIDTH``: minimum width of a message frame.\r
\r
+- ``NOTIFY_FORMAT``: format of a notification.\r
+\r
- ``MESSAGES_DISPLAY``: default messages to display on 'inbox' or 'sent' command.\r
\r
- ``TREND_MAX``: default trends to display on 'trend' command.\r
\r
- ``LIST_MAX``: default tweets to display on 'list home' command.\r
\r
-- ``ONLY_LIST``: filter list on 'switch' command.\r
+- ``ONLY_LIST``: filter list on 'switch' command. Eg: ["@fat","mdo"]\r
\r
-- ``IGNORE_LIST``: ignore list on 'switch' command.\r
+- ``IGNORE_LIST``: ignore list on 'switch' command. Eg: ["@fat"]\r
\r
- ``HISTORY_FILENAME``: name of file which stores input history.\r
\r
\r
- ``IMAGE_MAX_HEIGHT``: max height of image in '-iot'/'--image-on-term' mode.\r
\r
+- ``STREAM_DELAY``: seconds to wait before displaying another tweet, will drop all tweets while waiting. This value can be used to slow down the stream.\r
+\r
- ``USER_DOMAIN``: user URL of Twitter Streaming API.\r
\r
- ``PUBLIC_DOMAIN``: public URL of Twitter Streaming API.\r
+ ``#recipient_name``: Message's recipient name\r
+ ``#recipient_nick``: Message's recipient screen name\r
\r
+- ``POCKET_SUPPORT`` : enable Pocket support.\r
+\r
+In every format, you can use unicode characters like ``\u2665``.\r
+Mac users also can use emoji characters as well (Ex: ``::zap::``).\r
+See `Emoji cheatsheet`_ for details.\r
\r
Development\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
+ PCKT_CONSUMER_KEY = 'PocketAPIKey' # Your Pocket application's API key\r
\r
- Use pip to install in local\r
\r
source venv/bin/activate\r
pip install -e .\r
which rainbowstream # /this-directory/venv/bin/rainbowstream\r
- pip list | grep rainbowstream # rainbowstream (0.x.x, /this-directory)\r
# Remove ~/.rainbow_oauth if exists\r
rainbowstream # local version of rainbowstream\r
\r
.. _clang unknown argument: http://kaspermunck.github.io/2014/03/fixing-clang-error/\r
.. _Issue #10: https://github.com/DTVD/rainbowstream/issues/10\r
.. _default config: https://github.com/DTVD/rainbowstream/blob/master/rainbowstream/colorset/config\r
-\r
+.. _Emoji cheatsheet: http://www.emoji-cheat-sheet.com/\r
+.. _Pocket API: http://getpocket.com/developer/docs/overview\r