Project

tweetwine

0.0
Repository is archived
No commit activity in last 3 years
No release in over 3 years
A simple but tasty Twitter agent for command line use, designed for quickly\nshowing the latest tweets.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 0.3.0
~> 2.12.1
~> 0.11.3
~> 1.3.0
>= 0.8.7
~> 0.7.3
~> 0.3.5
~> 1.8.6

Runtime

~> 0.4.4
 Project Readme

tweetwine

DESCRIPTION

Tweetwine shows the latest tweets from the command line quickly.

The program can show the home timeline of the authenticated user, the latest tweets of friends and followers, and the latest tweets that mention the user. If that's not enough, Tweetwine can search statuses with arbitrary terms and send status updates.

Features:

  • Simple to use command line interface, with Bash completion support
  • ANSI coloring of statuses, but in discreet manner
  • Supports shortening URLs in a status update with a configurable shortening service
  • Configuration file for preferred settings

INSTALL

Install Tweetwine with RubyGems:

$ gem install tweetwine

The program is tested with MRI 1.8.7, 1.9.2, and 1.9.3. Build Status

The program requires oauth gem to be installed. In addition, the program needs a JSON parser library, such as json gem, on Ruby 1.8.

This documentation page is also provided as a manual page. Use gem-man to see it:

$ gem man tweetwine

BASIC USAGE AND CONFIGURATION

In the command line, run the program by entering

$ tweetwine [global_options..] [command] [command_options...]

For all the global options and commands, see:

$ tweetwine help

For information about a specific command and its options, enter:

$ tweetwine help <command>

In order to use to use the program, you must authorize it to access your account on Twitter. This is done with OAuth protocol, and it is required when the program is launched for the first time. After that, Tweetwine remembers the access you granted by storing the access token into ~/.tweetwine. The file serves as your configuration file.

Because the access token is sensitive information, Tweetwine obfuscates it when storing it into the configuration file. While this prevents simple plain text reading attempts of the access token, it is not secure. You should restrict access to the file only to yourself. If the configuration file does not exist before running the program, Tweetwine sets the file accessible only to you when storing the access token.

The configuration file is in YAML syntax. In addition to the OAuth access token, the program recognizes the following settings:

colors: true|false
username: <your_username>

URL shortening for a status update

Before actually sending a new status update, it is possible for the software to shorten the URLs in the tweet by using an external web service. This can be enabled via shorten_urls field in the configuration file; for example:

username: spoonman
colors: true
show_reverse: true
shorten_urls:
  service_url: http://is.gd/create.php
  method: post
  url_param_name: url
  xpath_selector: //input[@id='short_url']/@value
  disable: false    # optional

The supported HTTP request methods (in method field) are get and post. The method chosen affects whether parameters are passed as URL query parameters or as payload in the HTTP request, respectively. Extra parameters can be given via extra_params field, as a hash.

The xpath_selector field is needed to locate the HTML element which contains the shortened URL from the HTTP response.

URL shortening can be disabled by not defining shorten_urls field in the configuration file, or by setting optional field disable to true. In order to disable shortening only temporarily, use the command line option --no-url-shorten.

NOTE: The use of URL shortening requires nokogiri gem to be installed.

HTTP proxy setting

If $http_proxy environment variable is set, Tweetwine attempts to use the URL in the environment variable as HTTP proxy for its HTTP connections. This setting can be overridden with --http-proxy and --no-http-proxy command line options.

Bash command line completion support

Bash shell supports command line completion via tab character. If you want to enable Tweetwine specific completion with Bash, source the file tweetwine-completion.bash, located in contrib directory:

. contrib/tweetwine-completion.bash

In order to do this automatically when your shell starts, insert the following snippet to your Bash initialization script (such as ~/.bashrc):

if [ -f <path_to_tweetwine>/contrib/tweetwine-completion.bash ]; then
    . <path_to_tweetwine>/contrib/tweetwine-completion.bash
fi

COPYRIGHT

Tweetwine is copyright © 2009-2011 Tuomas Kareinen. See LICENSE.txt.

SEE ALSO

https://github.com/tkareine/tweetwine