============================================================================= GetShellCommands plugin for WiRNS 1.x Version 1.1 (04/18/04) By j.m. ============================================================================= ___________ Description The GetShellCommands plugin proxies requests to getshellcmds.pl on the ReplayTV servers and (optionally) allows WiRNS to return custom shell commands to be executed by your ReplayTV 4xxx/5xxx instead. Its uses are limited only by your imagination and willingness to experiment with shell commands. Be warned, however, that THIS PLUGIN IS INTENDED FOR ADVANCED USERS ONLY. It makes no attempt to control, modify, error check, or restrict the shell commands you specify. Use of this plugin could harm your ReplayTV. Please read and acknowledge the DISCLAIMER below before installing and using this plugin. ____________ Installation For existing WiRNS users: To install the plugin, place the "GetShellCommands.dll" file in the "Plugins" sub-folder within the folder containing the "WiRNS.exe" file. For new WiRNS users: It is possible to use this plugin with a very minimal installation of WiRNS. To do so, follow this subset of the normal WiRNS installation instructions: - Download WiRNS v1.x and unzip it to a folder - Place the included "GetShellCommands.dll" file in the "Plugins" sub-folder - Start WiRNS by double-clicking the "StartWirns.bat" file - Configure WiRNS by browsing to "http://127.0.0.1:8923" in your web browser Click Configuration->WiRNS Set "WiRNS IP" to the IP address of your PC Set "DNS Server" to the IP address of a working DNS server (e.g. the IP of your ISP's DNS server *or* the IP of your router) - Close the WiRNS server by closing its console window - Restart WiRNS by double-clicking the "StartWirns.bat" file again - Reconfigure your ReplayTV to connect via WiRNS Go to Menu->Setup->Network and Input Settings->Change network Configure the ReplayTV to use a static (manual) IP Set DNS1 and DNS2 to the "WiRNS IP" you specified above For users of WiRNS v0.7a: This version of the GetShellCommands plugin is backwards compatible with WiRNS v0.7a. However, installation and usage is a little different with the earlier version of WiRNS. Please read the included "LEGACY.TXT" file (in addition to this README) for details. _____ Usage To return custom shell commands, create a file named "shellcmds" in the folder containing the "WiRNS.exe" file (NOT in the "Plugins" sub-folder). Using any text editor, type the custom shell commands into the "shellcmds" file. The format is one command per line. Save the file. During a net connect, the message "[PLUGIN] GetShellCommands using shellcmds from file" should appear in the console window. NOTE: if the "shellcmds" file exists but is empty, *no* shell commands will be returned. If the "shellcmds" file does not exist, the request will just pass through to the server, and the message "[PLUGIN] GetShellCommands using shellcmds from server" should appear in the console window. ____ Tips ***INSTALLATION*** - If you do not know the IP address of your PC or your DNS servers, you can find them by typing "ipconfig /all" at a command prompt. Look for the "DNS Servers" entry and use the first one listed for the "DNS Server" setting in the WiRNS configuration. You can also enter the "IP Address" listed there for your "WiRNS IP." - Assuming your router forwards DNS requests (as most do), you can use the router's IP address for the "DNS Server" when configuring WiRNS. - Unless you want to use WiRNS for its other features such as custom guide data etc., you do not need to enter any info about your ReplayTVs, DataDirect, etc. when setting up WiRNS. Just stick to the steps I listed above. ***USAGE*** - You can force the ReplayTV to net connect at any time using the 243-zones shortcut or by using the "Connect to ReplayTV Service Now" option in the ReplayTV setup menu. - If GetShellCommands does not seem to be using the contents of the "shellcmds" file, make SURE you placed the "shellcmds" file in the same folder as the "WiRNS.exe" file. Do *not* put it in the "Plugins" sub-folder, as it will not be used there. - Generally, once you use GetShellCommands/WiRNS to modify a setting on your ReplayTV, you can restore your regular network configuration on the ReplayTV. I.e., you can then connect normally (without WiRNS), and the settings will not be changed. There are a few exceptions such as the settings relating to whether to show pause ads. ***TROUBLESHOOTING*** - Start WiRNS from a command prompt instead of double-clicking from Windows Explorer. This way the WiRNS console window will not close if an error occurs, which will allow you to record the error and report it. - You cannot run WiRNS and any other HTTP server--e.g. DVArchive, IIS, Apache, etc.--on the same PC at the same time (unless all such servers are bound to separate IP addresses). WiRNS works by binding port 80 (HTTP) on the "WiRNS IP" you specify. That means WiRNS will not work properly if another program has already bound port 80 of that IP. If you are having problems getting your ReplayTV to connect through WiRNS, try typing "netstat -an" into a command prompt while WiRNS IS NOT RUNNING. Look for any entries that have ":80" with "LISTENING" beside it. If the IP address for that entry is "0.0.0.0" or matches your "WiRNS IP" then something else is binding port 80, which prevents WiRNS from working. The same is also true with regard to running any other program that binds port 53 (DNS). - If your ReplayTV is not able to communicate with WiRNS, ensure that you are not running any firewall on the WiRNS PC (or configure the firewall to permit WiRNS to communicate). Otherwise, it will block the necessary communication between the ReplayTV and WiRNS. In particular, be sure to disable the firewall that is included with Windows XP (the Internet Connection Firewall or Windows Firewall). NOTE: Windows XP Service Pack 2 will enable the Windows Firewall by default, so it is critical to check this when troubleshooting. _____ Links WiRNS http://wirns.sourceforge.net ReplayTV FAQ http://www.replayfaqs.com ReplayTV TWiki http://www.molehill.org/twiki/bin/view/Replay/WebHome __________ DISCLAIMER THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.