Tweetuoso is a very light Twitter Command-line client developed in Python.
Project description
Tweetuoso is a very light Twitter Command-line client developed in Python. The main goal of Tweetuoso is to become a fully-fledged twitter client with the same functions as the online version.
For now, it allows you to:
check your timeline
post tweets
show tweets that mentionned you
retweet a tweet
get your profile details
follow or unfollow people
search for ‘query’
stalk people (or yourself)
show current trends
automatically followback your followers
Archive all your tweets to a text file
stream tweets (sample or filter mode)
send / read direct messages
More is still to come…
Installation
Pre-requisites:
Python 2.6+ (not tested with Python 3+)
tweepy >= 2.1 (for a Twitter API connection, obviously)
GitPython 0.3.2 (if you wish to use tweet_commit)
python-setuptools
requests 1.1.0
colorama 0.2.5
pytz
Working API keys from Twitter
From source
Remember to configure Tweetuoso’s config.py file before installing!
Get the latest version (from GitHub):
$ wget -O /tmp/tweetuoso-master.zip https://github.com/c0ding/tweetuoso/archive/master.zip $ sudo apt-get update $ sudo apt-get install python-setuptools python-tweepy python-requests python-colorama python-pytz $ cd /tmp $ unzip tweetuoso-master.zip $ chmod -R 777 tweetuoso-master $ cd tweetuoso-master $ nano /tweetuoso/config.py (edit variables) $ python setup.py install
From PyPi
$ pip install tweetuoso
Configuration
Step 1: Register a new client app with Twitter
Navigate to https://dev.twitter.com/apps/new. You might have to log into the Twitter Developers site first, if you’’re not already. Fill in the registration fields.
Note: whatever you specify for Application Name will be the via
name your followers see in the details of tweets issued from your command line app.
Step 2: OAuth settings
Next, the app needs to be authorized to connect to your account so it can send tweets under your name. Paste the Consumer Key and Consumer Secret into config.py file. Then save and run Tweetuoso on your system.
You should see a prompt like this:
$ Please visit this url to get your access keys: <url> $ PIN:
Open that URL in your browser. You should see the standard OAuth Twitter connection screen. Click Allow.
Twitter will then provide you with a PIN code that authenticates the connection between the client app and your Twitter account.
Enter this PIN into the Tweetuoso prompt:
$ PIN: 2781961
Tweetuoso will then print out another key/secret pair: (The values will be different each time!)
$ access_token = '124242RCyi3g0cZ4r5BWL047rsh0S0yv5VxAGwTKCOsHAb' $ access_secret = 'kaTXiC489qo8y6haTBSlwOqR1syG83tzPG2StdQ'
Keep this information on your screen because well need it in the next step.
Step 3: Paste the keys into Tweetuoso
Paste the Access Token and Access Secret from the end of step 2 into the auth.py file, filling the access_token and access_secret constants.
Step 4: Application Type
On the Twitter Developer website, navigate to the Settings tab. Allow your application Read, Write and direct messages access.
Finally, were all set up. Our command line app is registered as a Twitter client and the app is connected to our Twitter user account.
Running
Simply follow the steps above, edit the config.py file to suit your needs and launch tweetuoso.py. Enjoy!
License
Apache v2.0 License Copyright 2013 Martin Simon Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Thanks to
Sven Steinbauer (Svenito on Github)
Buy me a coffee?
If you feel like buying me a coffee (or a beer?), donations are welcome:
WDC : WbcWJzVD8yXt3yLnnkCZtwQo4YgSUdELkj HBN : F2Zs4igv8r4oJJzh4sh4bGmeqoUxLQHPki DOGE: DRBkryyau5CMxpBzVmrBAjK6dVdMZSBsuS
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
