BeeTV 0.90b Installation and Usage Manual ----------------------------------------- BeeTV Features -------------- BeeTV is an automatic torrent indexer and show tracking device. It is designed to continually poll different sites for releases and will eventually build a rather large tree of available shows as they appear. This is all done automatically with minimal interaction from the user. BeeTV will, when correctly configured, also download torrents matching a certain criteria the user has set up once it finds them. BeeTV is centralized around the Subscription system and the Shows indexer. The subscription system lets the user subscribe to shows of a specific format or shows of all formats from a specified torrent source. The Shows Indexer is the backend of the program which indexes and updates the shows list dynamically as new shows and formats appear, giving the user a list of options to choose from when subscribing to shows. Requirements ------------ BeeTV requires the Microsoft NET Framework to be installed on your computer. If you have SP2 this should be enough. If the program still will not start, try downloading Microsoft NET Framework from the link below. http://www.microsoft.com/downloads/details.aspx?FamilyId=262D25E3-F589-4842-8157-034D1E7CF3A3&displaylang=en Installation ------------ To install, just unzip contents to a directory. An install handler will come later. Be sure to have your BeeTV.xml file in the same directory as the executable. To start program just double click on the BeeTv.exe file. Usage ----- BeeTV is an automatic RSS indexer and torrent downloader. BeeTV does require you to have a proper BitTorrent client installed however. Your client must be a client that takes a torrent file as a program start argument, like C:\PROGRAM\BITTORNADO\BTDOWNLOADGUI.EXE Recommended programs that should work properly are BitTornado, BitTorrent, ABC, Azareus. To make downloading easier you should modify the settings in your BT-client to automatically start downloads on start. Otherwise BeeTV won't be able to download them in the background - instead it will require you to click somewhere in your client to start the download. Configuring BeeTV ----------------- - BitTorrent client To use your BitTorrent client with BeeTV, click on the Settings button in BeeTV and click the folder icon next to the textbox (or just type in the path to the client). Next, in the file dialog, find your BitTorrent client and choose the executable file. For example, BitTornado ordinarily is found in C:\Program\BitTornado and the client executable is named btdownloadgui.exe. You should choose this file. - Check feeds interval BeeTV will automatically poll the sites that are in your configuration for new releases at a specified interval of time. To set this interval change the numerical value of minutes to wait before each poll in the Settings window. The default value is every 15 minutes. - Automatic start BeeTV can start automatically when your computer boots (or will eventually). To configure this option, check the box in Settings and it will boot. Using BeeTV ----------- BeeTV most powerful feature is the subscription feature. While BeeTV will continually search the net for new releases and index them as they appear, you will need to subscribe to a specific show to download it when it is released. BeeTV will always check all new releases on startup and will focus on the Shows window, where all shows available in the program are visible. - Subscribing To subscribe to a show, you select it in the main window and right-click. If you have selected the main tree of the show you will have the option to Subscribe | All releases. If you choose this you will subscribe to all current releases of this specific show. To subscribe to only a certain release of a show, for example a HDTV release, you simply expand the show's subtree and right-click. Then choose Subscribe | Only this type. - Subscription Window Clicking the button named "My Shows" will bring you to your currently subscribed shows. Here you can browser which shows you are currently subscribing to, and from which source. To remove a subscription, either select it in the tree and press the 'delete' key, or choose the Menu option "Select | Delete" - Search bar You can also search all shows matching a certain criteria. Just type in the bottom input box and it will bring up all shows matching your search. To subscribe to these, simply right-click as above and choose the appropriate option. - Check feeds If you don't feel like waiting until BeeTV automatically checks new releases you can force it to check any new releases by clicking the menu option "File | Check feeds" - Minimizing When minimized, BeeTV will appear in your System tray. That is, the lower right hand corner of your screen. It will appear as a small bee icon in the tray and can be brought into focus by either double-clicking on it or right clicking and selecting "Show" in the menu options. There are also some other options to choose from in this menu without bringing the main window up. Frequently asked Questions -------------------------- Q. I clicked start automatically on boot but it won't start?? A. This feature has not been implemented yet. It will be in the next version. Q. The show "X" doesn't exist! A. If show "X" is released periodically on your tracker, BeeTV will index it eventually. You can add it yourself by tinkering in the BeeTV.xml file, look below for information. Q. Site "X" changed sites and/or rss-feed links. How do I fix? A. Change values accordingly in BeeTV.xml, look for the tag inside the tags in the configuration. Q. Shows are not listed alphabetically! A. I know, I was too lazy to implement it. Advanced Options ---------------- - FEEDS While BeeTV automatically indexes the feeds configured in BeeTV.xml there is, as of yet, no feature to add new feeds in the program. To add a new feed to check you will first need to determine a suitable regular expression to differentiate between files. You can most often find this by looking at the feed page, for example: http://www.tvtorrents.tv/rss.php the regular expression used here is "%showName\s[0-9]+x[0-9]+.+\(%showType\)" which indexes all files looking like x() Take for example a release called: Mr Hanky 1x19 (HDTV-PiP) this will match "Mr Hanky" to and "HDTV-PiP" to the Now, if you want to add this new feed you must open up BeeTV.xml and find the last tag in this document. It must be the last one, or else all subscriptions in the program will be broken as they are indexed by the number they appear in BeeTV.xml Then to add your feed type in the following tags. Name Of Feed http://link.to.the/rss/feed The regex you have made Make sure you add ALL these values, and correctly, or BeeTV might get confused and crash at any time. - SHOWS To add a new show (that hasn't been indexed by BeeTV yet or doesn't show for some reason) you can add it yourself in the BeeTV.xml file. First move down to the appropriate tag corresponding to the feed you want to add a show for. Inside these tags you might notice a bunch tags if your BeeTV has indexed some shows already. To add one yourself just put the following tags inside the part of the document (though not inside another tag!!) Title of show If you want to add a new show format, for example "HDTV-PiP" you need to add the value HDTV-PiP as well, in between the same tags. The end product would then look like: Title of show HDTV-PiP Warning: If you haven't followed the conventions in naming as specified in the FEEDS part above BeeTV won't index new formats of this show appropriately. Note: You can also add new 's inside already existing 's If you have any questions or comments, please feel free to email them to: pascal.eppstein@gmail.com Copyright 2005 - all rights reserved.