TellyBot is an IRC bot that provides an interface to TV listings information from an IRC channel. It currently allows you to search for programmes, find out about programmes and set reminders for programmes. It uses Paul Mutton's PircBot package.
Bear in mind that TellyBot is still in development, so check back often for updates. To contact me about TellyBot, send an e-mail to email@example.com.
The current version of TellyBot is 0.1 ( ). This is a work in progress release and not everything is guaranteed to work!
How to Run TellyBot
First off, you need to use an XMLTV grabber to generate an XML file in XMLTV format. See http://membled.com/work/apps/xmltv/ to download the XMLTV grabbers. Alternatively, I have put a sample XMLTV file here - I can't promise that I will keep it updated at the moment, so use it at your own risk as the listings schedule will eventually expire. Once you have your XML file you need to upload it to a web server somewhere (local access will be added later!). You will then need to download PircBot from http://www.jibble.org/pircbot. Then, assuming that pircbot.jar and tellybot-0.1.jar are in the current directory, run the following command:
java -cp pircbot.jar;tellybot-0.1.jar
is the name of the bot,
is the URL of the server to join,
is the name of the channel to join,
is the path and filename of the file to store reminders in,
is the URL to the XMLTV file and
is the maximum number of search results to return from searches (keep
this reasonably low in order to stop TellyBot from flooding the
Here is a list of commands that TellyBot understands:
about- Display the current version number for TellyBot.
help- Display the list of commands that TellyBot understands.
channels- Display a list of all the channels that TellyBot knows about.
find <string>- Search programme titles and descriptions for the search
info <result>- After doing a search, this will display detailed information for the specified search result.
now <channel|all>- If a
channelis specified, TellyBot will display the next four programmes on that channel. If "
all" is specified then TellyBot will display the next four channels on all the channels that it knows about.
remind <result>- After doing a search, this will set a reminder so that TellyBot will remind you to watch the specified search result.
when <string>- Similar to
findbut only returns programmes whose title exactly matches
- 0.1 - 14th April 2004
- Initial Version.
Licensing and Warranty
This software is provided without warranty of any kind and I cannot be held responsible for any loss occured by errors in the software.
© 2000-11, Jonathan Stott.
17 Jan 2019 03:46:02 GMT