https://github.com/diegok/twitirc

IRC/twitter bot that can speak both ways
https://github.com/diegok/twitirc

Last synced: about 1 month ago
JSON representation

IRC/twitter bot that can speak both ways

• Host: GitHub
• URL: https://github.com/diegok/twitirc
• Owner: diegok
• Created: 2010-12-14T11:28:42.000Z (about 14 years ago)
• Default Branch: master
• Last Pushed: 2013-02-20T10:21:22.000Z (almost 12 years ago)
• Last Synced: 2024-04-14T16:03:20.651Z (9 months ago)
• Language: Perl
• Homepage:
• Size: 609 KB
• Stars: 5
• Watchers: 3
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.pod

Awesome Lists containing this project

README

        
=head1 Twitirc

IRC bot to filter twitter stream api and to publish updates.

=head3 Version 0.1

=head2 Install

    

If you have curl, you can install all you need just running:

    > bin/install_deps.sh

=head2 Config

    conf/twitirc.conf

Just a json file for IRC and twitter configuration and state storage.

    {

       "host":     "irc.perl.org",

       "nickname": "twitirc",

       "channels": [ "#madrid.pm" ],

       "twitter":  {

          "filter":"perl,madrid,perlmongers",

          "access_token_secret":"XXX",

          "access_token":"XXX",

          "consumer_secret":"XXX",

          "consumer_key":"XXX"

       }

    }

Do you need help getting oauth credentials from twitter for your bot?, 

just exec:

    bin/get_token

=head2 Run

    bin/twitirc

=head2 Commands

Any message sended on the channels the bot is listening that start with

exclamation mark (!command) are interpreted as a command, then, no all

commands exists, so, try !help

Only channel op/voice's are trusted by the bot.

=head3 !help

Ask for bot usage to himself.

=head3 !filter [ view | [add|del] term ]

View or modify search terms for the live twitter stream api. Messages

passing this filter will be broadcasted to the first configured channel.

=head3 !tweet [ text to update twitter ]

Post an update to the bot twitter account.

=head3 !retweet [ other tweet ID ]

Retweet by api ID.

=head3 !reply [ other tweet ID ] [ reply message ]

Reply some tweet by its api ID.

=head3 !broadcast_rt [ on | off ]

Broadcast filtered retweets or not. That's the question!

=cut

=head2 Licence

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.