IRC Commands:

TV can be called by 3 methods
'tv', '!tv' and '@tv'

tv and !tv are the same, and generally send information to the channel, this is overridden by user/channel settings
@tv sends all information via a notice directly to you, this is not overridden by user/channel settings

IRC Command
!tv [-dilgstvnN] [channel[,channel2[,...]]] [[dd/mm/yy ]HH:mm]

Switches
-d : Displays when the program will start in respect to now | (BBC1 South) [36m 1s ago]: Film: Uncle Buck
-i : Shows the program ID | (BBC1 South) [13:55pm]: Film: Uncle Buck 148
-l : Displays how long the program lasts in Xm Ys format | (BBC1 South) [13:55pm]: Film: Uncle Buck (1h 30m)
-g : Displays the Genre of the program, note Film genres are always shown | (ITV1 Meridian) [12:50pm]: Soaps: Coronation Street Omnibus
-s : Displays if the program has Subtitles | (BBC1 South) [13:55pm]: Film: Uncle Buck (S[teletext])
-t : For use with -d, displays the time as well as the respective time | (BBC1 South) [13:55pm 37m 25s ago]: Film: Uncle Buck
-v : Displays Video+ codes for the program | (BBC1 South) [09:10pm]: Archangel: 1/2 464971
-nN : Changes the number of programs are shown, Default is 2 for listings, and 10 for search | N.B. This has to be the 'last' switch | (BBC1 South) [13:55pm]: Film: Uncle Buck [15:25pm]: Film: Antz [16:45pm]: Final Score

Examples
!tv - List the 'standard' channels [has channel/user overrides]
!tv bbc - List all the channels that match 'bbc' so bbc{1-4}
!tv 20:00 - List the 'standard' channels at the time: 8pm today
!tv 01/04/05 9:15pm - Lists the 'standard' channels at the time 9:15pm on the first of april 2005


IRC Command
!tv [-dfqvnN] search <query>

Switches
-d : Displays when the program will start in respect to now | 1: <76469> (BBC1 South) [in 6d 1h 31m (30m)] Dr Who Introduction
-f : Perform a full text search - This is an advanced search type - See examples
-q : Order results by relevence not soonest program, only works with -f | 1: <71571|7.962> (Five) [Tommorow 08:30pm - 09:00pm] Fifth Gear: 1/10
-v : Displays Video+ codes for the program | 1: <76469|7107> (BBC1 South) [Mar 26th 05:25pm - 05:55pm] Dr Who Introduction
-nN : Changes the number of programs are shown, Default is 10 | N.B. This has to be the 'last' switch

Examples
!tv search dr who - searches for all programs that contain dr and who
!tv search "house" - searches for all programs that only contain the word house
!tv -f search scrapheap >challenge -USA - searches for all programs that may contain scrapheap, are prefered to contain the word challenge and does not contain the word USA - see http://dev.mysql.com/doc/mysql/en/fulltext-boolean.html for more information


IRC Command
!tv [-lgprstN] remind <progID>

Switches
-l : List the current reminders
-g : Creates a global reminder | !tv -g remind <progID>
-p : Set the reminder to be private, so only you are notified
-r : Removes a reminder | !tv -r remind <ID> - ID being the reminder ID
-s : Ignores any Scheduled reminders, for use with -l
-t<times> : Sets how long before the program starts you want a reminder
-t : Lists the reminders happening today: works with all the standard switches


Examples
!tv -l remind - List current global and channel reminders
!tv -g remind 70512 - Add a global reminder for the program ID: 70512
!tv -r remind 64 - Removes the reminder for the ID: 64
!tv -ls remind - Only lists non schedules reminders
!tv -tX[,Y[,Z[..]]] remind <progID> - this will make the program remind at all the times specified
!tv -t10,5 remind 25413 - Will add a reminder for program ID: 25413, with reminders at 10, 5 and 0 minutes
!tv -t remind - Lists what public/global reminders there are for the next 24 hours
!tv -tid remind - Lists what public/global reminders there are for the next 24 hours and displaying there ID and how long till each of them starts


IRC Command
!tv [-cdgilp] schedule [channel] <ID|query>

Switches
-c : Only set a reminder when the program is on a specific channel | !tv -c schedule <channel> <query>
-d : Delete a schedule | !tv -d schedule <ID>
-g : Creates a global schdule | !tv -g schedule <query>
-i : Displays information about a schedule | !tv -i schedule <ID>
-l : List the current schedules | !tv -l schedule
-p : Set the schedule and reminders to be private, so only you can see it and are notified, can also be used with -l

Examples
!tv -c schedule bbc2 buzzcocks - Adds a public schedule for the query 'buzzcocks' on the tv channel bbc2
!tv -c schedule "sky one" sg-1 - Adds a public scheudule for the query 'sg-1 on the channel 'sky one'
!tv -d schedule 18 - Deletes the schedule ID: 18
!tv -g schedule buzzcocks - Adds a global schedule for the query 'buzzcocks' on any channel
!tv -i schedule 18 - List the current reminders that schedule ID: 18 currently has set
!tv -l schedule - List the current schedules


IRC Command
!tv [-c[alr]n] user [on/off] [channel]
!tv [-c[alr]n] ircchannel [on/off] [channel]

Switches
-c : Specify that you are dealing with the channel list
-a : Adds a tv channel to the channel list | !tv -ca <user|ircchannel> <tvchannel>
-l : Lists the current channels on the list
-r : Removes the channel from the list | !tv -cr <user|ircchannel>
-n : Change whether all messages should be sent via a notice or to the channel | !tv -n <user|ircchannel> <on|off>

Examples
!tv -ca user bbc1 - Adds the channel 'bbc1' to the users personal channel list
!tv -cl ircchannel - Lists the irc channels default tv channels
!tv -cr user bbc1 - Removes the channel 'bbc1' from the users personal channel list
!tv -n user off - Sets the users notice to off, so by default messages are sent to the channel


IRC Command
!tv details <progID>
!tv details <channel> <time>

Examples
!tv details 70214 - List program details and description for the program ID: 70214
!tv details bbc2 8:15pm - Lists the programs details that is on bbc2 at 8:15pm

Result
>> tv details 71380
(Channel 4) [06:30pm - 07:30pm in 1h 53m] Game show: Scrapheap Challenge USA: 2/4 (1h) (S[teletext])
The popular mechanical engineering series features four American teams in a race across the US, modifying their vehicles as they go. The inhospitable terrain of Death Valley poses a serious challenge for the teams who are required to convert their motors into dune buggies capable of handling waves of 20-foot sand dunes.


IRC Command
!tv videoplus <progID>
!tv video+ <progID>

Examples
!tv video+ 70214 - Give the video+ details for the program ID: 70214

Notes
Only selected channels have video+, due to strange things happening when it goes > 6 digits, so at the moment only bbc1, bbc2, itv, channel 4, itv2.