BBBot is a simple IRC bot written in python using irclib. It's a simple bot that enables selected users to add links/text to be displayed when other users use assigned commands. Primarily wiritten to share stream/download links and/or episode info for TV Show Breaking Bad over IRC It also displays information when the next episode airs and its name, and it has imdb module which can display info from IMDb, currently only sqlite database with predefined data is used. The data is saved using shelve. Should work on every 2.6+ python. Tested and developed on python 2.7.3. For IMDb sqlite3 is used, when finished the bot will automatically retrieve episode info and add it to sql database, only stream and download links will be added manually. This isn't really done yet though.

This project is more or less abandonware. Last update fixed all major security issues, and many bugs. The only thing that still needs to be done is imdb stuff.

I will perhaps sometime in the future update it, but it's not very likley.

Commands are divided into 3 categories, admins, authortized users and normal users.

All commands except the ones for normal users can be used via private chat i.e. they don't have to be said to bot publicly on a channel.

All commands: '.time','.ban','.unban','.ath','.rmath','.join','.quit','.say','.add','.remove','.update','!i','!download','!stream','!imdb','!suggest','.help','bot'

.turn <command> <on/off> - enables or disables any command from the list above, typing .turn bot off disables every command except .turn, bot will still be online but it will ignore all commands.

.ath <username> - adds to authorized list allowing them to use commands listed below under "Admins/authoritized nicknames" section. Note: list of authoritized usernames isn't saved i.e. is lost on restart.

.rmath <username> - removes from authorized list

.join <channel> - bot will join <channel>

.quit <channel> - bot will part from <channel>

.add <stream or download> <link> - adds link to stream or download list. can contain multiple words and spaces.

.remove <stream/download> <link> - Opposite of command above. Note: if you added link with multiple words this command can't remove only certain words. You have to enter same text as when it was added

.add sstream <link> - shortens link using goo.gl service and adds it to stream list, to remove it use .remove stream <shortened url>. When using sstream no additional text can be added with this command, it will return error if you try to use .add sstream <url> some descriptive text

.ban <username> and .unban <username> - disallow or allow to use any of BBBot's commands

.say <channel> <text> - if bot is present on it will say on that channel, channel can be entered as #<channel> or <channel>

.time <limit/notify> <seconds> - sets limit and notify values in seconds. limit is number of seconds that need to pass before command can be used again by normal users i.e. not in admin or auth list. notify is the minimu time that needs to pass before bot will warn someone that he can't use command due to limit limit.

To clear all stream links use .remove stream clear_all this will display current stream list in case you want to undo clear_all command.

!i - Shows next episode name, air time and link to reddit discussion thread. Example of displayed info:Next episode: [...] Latest reddit discussion thread S05E04 "Fifty-One" http://reddit.com

!stream - Shows links/text that has been added via .add stream command

!download - Shows links/text that has been added via .add download command, disabled by default.

!suggest <url> and/or <text> - suggest link to be added to stream/download list or sends message to BBBot's main channel.

!imdb <season>.<episode> - experimental, displays name, plot, and imdb link of <season>.<episode>. See bottom of this file on how to set it up. Disabled by default

To run BBBot on your own PC the following changes are necessarry:

In create_db.py change the following:

password - password to be used when bot joins, if nickname isn't registered leave it empty

banned - list of banned users, the users aren't allowed to use any command, even if user is in admin list. Banning using IRC commands will be implemented later on.

admin - people who will be on the admin list, the list can't be modified from IRC. Nicknames should be added as ['nickname','nickname2'] etc.

auth - list of people who are on authoritized list, users who are added in admin list should be manually added here too otherwise they won't be able to use commands assigned to users on authoritized list untill they're added to it.

initialch - list of channels that bot will attempt to join after it connects to server.

streamlinks - list of stream links, you could leave this empty and add them from IRC.

downloadlinks - same as streamlinks only for download links.

reddit - text that will be showed after !i command, "Latest reddit discussion" + text in reddit field. This can be edited from IRC using .update command

api_key - Your goo.gl API key.

After you modified create_db.py file run it python create_db.py and it should create database.db file, make sure this file is in same location as bblib.py and BBBot.py files.

On line 44 edit airtimes and episode names, enter airtimes according to GMT timezone if you want the numbers to be correct.

Modify server name on line 204, port on 205(default is 6667) and nickname on 206.

Make sure all files are in same folder and run BBBot.py.

IMDb is semi functional, to use it uncomment create_db() line in imdbdb.py file and run it.

To make the function accessable by anyone either remove it from self.disabledcmds in BBBot.py file or just run .turn !imdb on after bot connects to IRC.

Usage !imdb <season_number>.<episode_number> for example !imdb 1.8

SQL file can't be updated any other way than running imdbdb.py directly. The whole thing isn't really tested properly and probably has a lot of bugs and will make bot crash.