/ 
App-Twitch-0.004
River stage zero No dependents
/ twitch

NAME

twitch - command line tool to use twitch

VERSION

version 0.004

INSTALL

For installing twitch you need Perl on your system installed, you can download it on http://www.perl.org/ or for Windows Systems you can use http://strawberryperl.com/. With Perl you are able to execute the cpan command, the so called CPAN client. On Windows Systems you can startup the CPAN client with a link installed on the Strawberry Perl Start menu folder. You can then inside the cpan client do this:

cpan[1]> install App::Twitch

All questions inside the installation may be answered with the defaults, just hit enter if it stops :).

The installation may take a while, cause Perl checks if all the installed and required modules for this program are working on your system, with so called tests. This procedure is required to assure you that the application itself runs flawless and without problems. You may contact Perl people for help on irc.perl.org on #win32 or #perl-help. You are always welcome :).

IF YOU ARE NOT ROOT

If you are not root of the system, you are using for this bot, you should consider using local::lib, which gives you the possibility to install this package in your userspace. The documentation of local::lib exists in several languages.

USAGE ON WIN32

After install you could write a .BAT file with your favorite text editor like the following one, which you can execute and run on your machine all day:

  twitch \
	--consumer_key XXXXXXXXXXXXXXXXXXXXXX \
	--consumer_secret XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
	--access_token 111111111-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
	--access_token_secret XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
	--bitly_username XXXXXXXXXXXX \
	--bitly_apikey XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
	--rss_delay 1200

USAGE ON UNIX

After install you can use twitch like any other application on your system, all possible parameter are documented:

me@workstation:~$ twitch --help

You could prepare a small shell script like this:

  #!/bin/sh

  twitch \
	--consumer_key XXXXXXXXXXXXXXXXXXXXXX \
	--consumer_secret XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
	--access_token 111111111-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
	--access_token_secret XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
	--bitly_username XXXXXXXXXXXX \
	--bitly_apikey XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
	--rss_delay 1200

And then use it inside of a screen session on your host to let it run forever.

SEE ALSO

AUTHOR

Torsten Raudssus <torsten@raudssus.de> http://www.raudssus.de/

COPYRIGHT AND LICENSE

This software is copyright (c) 2010 by Raudssus Social Software.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.