Ren-Ren's Fserve Navigator (RFN) v3.51

Copyright© 2000-2002 by Adrian Au. All rights reserved.

The latest version can be found at: http://adrian.saxtus.gr (Backup: http://www.geocities.com/renx2)

I'm very interested in knowing how many people actually use this script. If you find the script useful, please send me an email with your name/nick, network, and any comments/suggestions. Thanks! My email is: renx2@yahoo.com

If you want to be notified of new versions, please let me know in the email.

RFN is free for you to download and use. Please don't rip it off. I spent an enormous amount of time and energy writing, testing and improving them. Although free, if you find RFN useful and want to reward my hard work, please consider making a donation. Thanks! :)

CONTENTS:

INTRODUCTION
INSTALLATION
HOW TO USE
NOTES
LICENSE AND DISTRIBUTION INFORMATION
HISTORY

Last updated on July 8, 2002


INTRODUCTION:

Ren-Ren's Fserve Navigator (RFN) is an mIRC script that makes finding files and getting files from IRC file servers (fserves) easier than ever. RFN is very versatile and extensively customizable with its many abilities and options. These are the main features:

  1. Advanced point-and-click interface to navigate Fserves, with file sorting by filename or size.
  2. Internal queue for automated downloading, extending any Fserve's queue limitation, with broken send retry ability.
  3. Fserves and XDCC catcher, sorted by user-specified criteria, and searchable with keywords and phrases.
  4. User-adjustable ad and trigger filter.
  5. Explorable offline Fserve cache directories, from which files can be added to internal queue.
  6. Auto-DCCAllow system with internal DCCAllow queue.
  7. Add-on system with add-ons like DCCAllow Editor, Timer Editor, and Hash Table Editor.
  8. Logging of queued/failed/received files for individual Fserves.
  9. Custom Fserve commands with parameter support.
  10. Anti-idle option.
  11. Multiple network support.

The script was tested on DALnet using mIRC v6.02 32-bit on a Windows 98 SE PIII-550MHz system. RFN may or may not work correctly in other versions of mIRC. There is no guarantee that the script will work 100% correctly. Use this at your own risk. Remember, if it hangs, press Ctrl-Break.

The script consists of: rfn-setup.mrc, rfn-system.mrc, rfn-dialog.mrc, rfn-catch.mrc, rfn-file.mrc, rfn-dmain.mrc, rfn-dopt.mrc, rfn-nav.mrc and rfn-catchevents.mrc

Various add-on script files are included in the Add-ons subdirectory.

rfndoc.htm is the file you're reading, and rfn-faq.txt contains additional notes (loaded into the RFN window's help tab). The license agreement is in rfn-license.txt. An icon file (rfn.ico) is also included. The button rfnhelp.bmp appears in the About window and was made by Bughunt.

Back to the top


INSTALLATION:

Extract the script files into a directory (preferrably one without spaces in the name). Open mIRC v6.02 (or above). Then type the following command in any mIRC window (replace "C:\mIRC\RFN\" with the directory you extracted the script to; the quotes are only needed if there are spaces):

/load -rs "C:\mIRC\RFN\rfn-setup.mrc"

The license agreement will be shown. If you don't agree to it, setup is halted. rfn-license.txt must be present and unmodified. Otherwise, setup will not proceed.

mIRC may pop up a warning message. RFN won't work if you don't let it initialize. During initialization, the required files are loaded and several variables are set up. These will generally be %rfn-[something]. After it has served its function, rfn-setup.mrc will automatically unload.

If you're updating from an earlier version, don't just overwrite the files. You should use the "Unload" command from within RFN. Unloading manually removes all RFN settings.

Back to the top


HOW TO USE:

To open RFN, press Ctrl-F12, type the command /RFN, or choose "Open RFN" in the channel popup menu or mIRC menu bar. When you connect to an IRC server, if the server does not return a network name, RFN will prompt you for one and add it automatically to its Network list.


Channels:

This tab displays the channels being watched for triggers, caught triggers, and various trigger information.

Channel listbox: The left listbox displays the channels you want to track. Modify the list with the "Add" and "Remove" buttons. The "Add" button opens a window listing all the channels you have joined but not in the channel list yet. You can add channel(s) by double-clicking on a channel, by selecting channel(s) and pressing the "Add Channel(s)" button, or by typing in the channel names (separated by spaces) in the edit box and pressing the "Add Channel(s)" button, or by pressing the "Add Channel(s)" button without selecting to add all listed channels. When you manually type a listing command in a channel, that channel is added automatically. (mIRC v6.02 does not respond to input that begin with !. Therefore, if your listing command begins with a ! and you are using mIRC v6.02, RFN cannot detect the event.) The box above shows the current Fserve listing command. To add a command, type it in and use it. Press the "List Selected" button to send the current listing command to selected channels (or double-click on a channel). Press the "List Active" button to send to the active mIRC window (or to the first channel if the active window is not a channel).

Use the "Save Channel" command to save a channel's list of Fserves. The information is saved to the RFN directory as set under "Options". Use the "Load Channel" command to load the information back. This replaces any existing information.

Triggers listbox: The middle listbox shows a channel's Fserves and FTP addresses. Modify the list with the plus/minus buttons. Be default, the » symbol represents people in your notify list ("Notify" button), the « symbol represents Fserves that should not be updated ("Keep" button), and the ø or × symbol represents marked Fserves ("Mark" button cycles through all the mark symbols). Press the "Refresh" button to reparse the ads. The number after the Fserve name denotes which ad the trigger came from, since some Fserves have more than one ad. Double-click on an entry to activate the trigger. If the trigger is an FTP address, you'll have to run an external FTP program.

The "Single Entry" checkbox toggles the "List Each Fserve as Single Entry" option, the "Clear on List" checkbox toggles the "Clear Fserves on List" option, and the "Sort" checkbox toggles sorting of Fserves according to open queue space (see Options).

You can search the Fserve ads using the editbox on the center bottom. Type in your query and press the "Search" button or the Enter key. You can use " quotes around phrases to refine searches. Note that the search does not check data you enter manually, only the original Fserve ads are searched. To get the full list of Fserves again, just select the channel again. To send the selected Find command with the query to the selected channel, press the "@Find/@Locate" button. (If the find command being used is not already in the list, it's automatically added.)

Fserve Information: This shows various information parsed from the ad. Double-click on a trigger in the box to activate it. The "Manual Entry" button allows you to correct information if RFN parses incorrectly. Separate multiple triggers by a separator (eg. &). If the separator character is actually part of the trigger, put ‹› around the character (eg. ‹&›. Note that it automatically adds the Fserve to the "Keep" list.

Original Fserve Ad: When an Fserve is selected, this shows the original Fserve ad and the time of the last update. For XDCC Fserves, the command, description, number of packs, and time are shown instead. If no Fserve is selected, the Channel topic is displayed with the time the !List trigger was last used. The box can be edited directly (except for XDCC). Any changes you make (above the bottom two lines) are saved immediately. The "Say Highlighted Text" button sends the highlighted text in the box to the selected channel.

Back to How To Use


Fserves:

Fserve navigation occurs here.

Fserves listbox: The top left box lists all the currently connected Fserves. Select an Fserve to begin navigation. Click "Start" to look at the Fserve Welcome message again. Click "Close" to close the Fserve. The "Refresh" button refreshes the subdirectories/files list by sending the "Dir" command. The box below shows the channel and trigger associated with the selected Fserve. Directly edit this if it is wrong. The "RFN for Navigation" checkbox is the same as the "Use RFN for Navigation" option.

Other chat connections: This lists all the other active DCC chat connections. Select one and press the "Browse Fserve" button if it is actually an unrecognized Fserve. The "Browse Fserve" button is inactive if no connections are listed.

Subdirectories listbox: The middle box lists all the subdirectories in the current directory (shown in the combo box above). Double-clicking enters the subdirectory. Click on ".." to return to the parent directory. The current directory box lists the previously accessed subdirectories in the session. Select one and click the "Go" button to enter the subdirectory. Click the "!" button to show the current path again.

Files listbox: The right box lists all the files in the current subdirectory. Double-click on a file (or select the file and click the "Get" button) to send the "Get" command. If multiple files are selected, the "Get" commands for all selected files are sent at once. The "IQueue" button adds selected files to RFN's internal queue, while the "IQueue Go" button runs the internal queue. The "Read" button tries to read the first selected file in the Files listbox. The "Sends", "Queues", "Stats" and "Clr_Queues" buttons executes the command as named. The clr_queues command clears the queue you may have on the current Fserve. The "Size" checkbox toggles the "Sort Files by Size" option.

Message box: Messages from the Fserves to you and vice versa are printed in this grey box near the bottom. This is provided for a quick look at recent messages only. Switch to the "Fserve Msg" tab if you want to see messages in a clearer manner.

Manual Entry edit box: The white edit box on the bottom is for you to chat or type commands in manually. Press the Enter key on the keyboard to send the message.

In the window that opens for "Fserve Welcome Message" or "Read" command, the "Copy" button copies all the text displayed in the window to clipboard.

Back to How To Use


Fserve Msg:

The "Fserve Msg" has a single box showing messages Fserves sent to you and vice versa. As with most boxes, highlight and right-click to copy text.

Back to How To Use


File History:

The "File History" uses the rfn.ini file. Please note that ini files should ideally be kept below 64 kb.

Networks: This lists the networks stored in the "File History". Modify the list with the plus/minus buttons.

Fserves listbox: This lists the Fserves stored in the "File History". Those who are currently on the channel where they advertised the respective Fserve have an "o" symbol, whereas those who aren't have an "x" symbol. Modify the list with the plus/minus buttons. The "IQ Go" button runs the internal queue of the selected Fserve.

Queued/Failed/Received Files listboxes: These list the respective files. The "All" button lists all queued, failed, or received files from the selected network. The plus/minus buttons are used to modify the lists. When "All" has been pressed, the minus buttons remove all corresponding entries from the selected network, whereas the plus button does nothing. The "IQueue" button adds the selected files to the internal queue. Double-click on a file to try to access the Fserve, provided that the needed information (channel, trigger, and path) is listed in the "File Information" box, and that you and the Fserve's owner are on the recorded channel. For failed files, RFN will try to get the file automatically after the Fserve opens. The Fserve will remain open until you close it.

File Information box: When a file is selected, this box in the bottom right shows the channel, trigger, path of that file, and number of retries. You can directly edit the box. Press the "Save" button to save (first 3 lines in the box must be present for "Save" to work). To cancel changes, just select the file in the listbox again. The "Run File" button runs the selected file in any of the three file lists (Queued, Failed or Received), provided it's still in the Get directory or the nickname's folder in the Get directory.

Back to How To Use


Cache:

This tab is similar to the "Fserves" tab. Fserves in the cache are shown in the left listbox. The ones with "o" in front are currently in the channel where the Fserve was triggered. Those that aren't have an "x" in front. The "Delete" button removes a selected cache. The cache of currently connected Fserves cannot be removed. The "Empty" button empties all Fserve caches. The "Rename" button renames a selected cache. The "Connect" button tries to connect to the selected Fserve. The box below the list of Fserves shows the channel and trigger used to open the Fserve. You can edit this information directly. The first line must begin with # to denote channel name, and the second line is the trigger.

The middle and right listboxes show the subdirectories and files respectively. Subdirectories whose contents are in the cache have the symbol "o" whereas those whose contents are not have the symbol "x". The box above the "Subdirectories" listbox shows the current directory. The "IQueue" button adds selected files to the internal queue. The "IQueue Go" button runs the internal queue. The "Load" and "Save" buttons load and save the cache respectively. The "Size" checkbox toggles the "Sort Files by Size" option. Double-click on a file to attempt to enter the Fserve and get the file. If you are currently connected to the Fserve, the file is added to the internal queue. If you double-click more files while trying to connect, these are added to the internal queue as well. You can add multiple files to the internal queue via the "IQueue" button.

Enter a query in the edit box and press the "Search" button to search selected cache(s). If no cache is selected, all will be searched. In the "Search Cache" window, double-click on an entry to add it to and start the internal queue. The "IQueue" and "IQueue Go" buttons are also available.

Back to How To Use


IQueue:

This tab displays the RFN internal queue. The left listbox shows all the Fserves with internal queues. Modify with the "Delete", "Empty" and "Rename" buttons. The bottom box may be edited directly. It contains the information required for the internal queue to run (channel, trigger, current file number/max queue number). The current file number means the number of files that RFN believes is currently queued on the Fserve. The max queue number is the maximum number of files that can be queued on the Fserve at a given time.

By default, when an Fserve's queue is full but you have no files queued on the Fserve (as reported by the "File History"), RFN sets a timer to retry queuing files from your internal queue onto the Fserve. The "Timer" button on the bottom left edits this timer. The time remaining with the number of retries (in parantheses) are shown in the read-only box next to the button.

The right listbox displays the files queued internally for the selected Fserve. You can modify the list and its order with the "Remove", "Up", "Down", "Top" and "Bottom" buttons. Any order changes are not saved until you press the "Apply" button. The "IQueue Go" button runs the internal queue of the selected Fserve. Use the "Load" and "Save" buttons to load and save IQueues.

Back to How To Use


Status:

This tab contains the Status box. Various RFN messages (eg. new fserve alert, suppressed ads and triggers) are shown here. Press the "Show Displayed Triggers" button to show triggers saved based on the "Displayed Triggers" option. The "Clear Messages" button clears the box.

Messages can be displayed in a separate window. It can be opened by selecting "Status Window" in the RFN menubar. In the RFN status window, Right-click on the window for commands to open RFN and clear the status window. Double-clicking on an empty status window closes it, while doing so on a window with messages clears it.

Back to How To Use


Options:

This is where you can change various options. Any changes you make are saved immediately.

System:

Open on Desktop: This sets whether the interface window opens on the desktop. One advantage to desktop windows is that there is a minimize button. Default is on.

Always on Top: This sets whether the interface window is always on top of all other windows (only applies when "Open on Desktop" is on). Default is off.

RFN Menu/Popup Commands: This toggles the RFN popup commands in the mIRC channel windows, mIRC menubar, and mIRC query/chat windows. Default is on.

Ini Size Checker: This sets whether RFN checks the size of the rfn.ini file when you open the RFN window. Ideally, the size should be below 64 kb. Removal of unneeded entries in the "File History" may be required to minimize errors. Default is on.

Status Messages Display Mode: This sets the display mode of various status messages. When checked, messages are always displayed in the RFN-Status window (window is opened automatically). When unchecked, messages are only displayed in the RFN-Status window if it is open. When greyed, messages are sent to the mIRC Status window if the RFN-Status window is not open. Default is greyed. Note that if the RFN window is open, messages are also sent to the "Status" tab.

Status Window Always on Top: This sets whether the RFN-Status window is always on top. Default is off.

RFN Directory: This is the RFN working directory (to load/save RFN files and to store rfn.ini). Single-click to change it. Default is the script directory.

Fserve Open Sound: This is the sound played when an Fserve is opened and ready. Single-click to change it. During selection, press the cancel button (or press Esc) to set to none. Default is c:\windows\media\chimes.wav if it exists. Otherwise, default is none.

Warn Close Idle Sound: This is the sound played when an Fserve gives the idle warning. Single-click to change it. During selection, press the cancel button (or press Esc) to set to none. Default is c:\windows\media\chord.wav if it exists. Otherwise, default is none.

Alert Sound: This is the general alert sound played (eg. when you double-click on a trigger in "Triggers" listbox or a file in the "Cache" or "File History", or when a new Fserve is found). During selection, press the cancel button (or press Esc) to set to none. Default is c:\windows\media\ding.wav if it exists. Otherwise, default is none.

Network List: If an IRC server does not return a network name, RFN will look up the network name of the server from this list. Modify the list with the plus/minus buttons. The "x" button clears the list. Each entry is in the form of: server network

For example, if irc.somewhere.net belongs to DALnet, type "irc.somewhere.net DALnet" and press the "+" button.

Window Size: Adjusts the size of the RFN window. Your choice of small, medium or large. Default is medium.

Autosave Freq: The frequency in seconds at which RFN will automatically save channel Fserve lists, Fserve caches, and internal queues. You can select any combination of the three to autosave. Note that autosave (if on) is also triggered when you are disconnected from a server. Default is 3600, with all three data types selected.

Autoload on Start: Select the data you want to autoload when RFN starts. The data must be in the Autosave subdirectory under the RFN directory. Default has IQueues selected.

Save Options to File: Saves all options to rfn.ini file, except for RFN directory and Network List.

Load Options from File: Loads previously saved options from rfn.ini file, except for RFN directory and Network List. If an entry is empty, the current option is kept.

Default: Resets all the options (except RFN Directory, Network List and Custom Fserve Commands) to default values.

Catcher:

Catch All Notices: This sets whether RFN will catch all notices from people on a channel in your channel list, regardless of whether RFN thinks it's an Fserve ad or not. Recommended to leave off unless you find RFN is not listing a lot of Fserve ads in your channel. Default is off.

Catch Ops/Voiced Only: When checked, RFN will catch ads only from ops and half-ops. When greyed, RFN will catch ads only from ops, half-ops, and voiced Fserves. Default is off.

Suppress Ads in Channels: This prevents Fserve ads from cluttering up the channel windows. Any ad caught by the RFN catcher will not show up in the channel windows. This is also useful to see what ads are not caught by RFN since only these would show in the channel windows. Turn "New Fserve Alert" on if you want to know when an ad is added. Default is on.

Echo Suppressed Ads to Status Window: This shows Fserve ads in the Status window if they were suppressed. This is provided in case you want to check those suppressed messages. Default is off.

Suppress Triggers in Channels: Fserve triggers, list triggers and find triggers are filtered from the channel window. Default is on.

Echo Suppressed Triggers to Status Window: This shows triggers in the Status window if they were suppressed.

New Fserve Alert: This sets whether to alert you with new Fserves. Default is off.

New Fserve Alert Sound: This sets whether new Fserve alerts play a sound. Default is on.

Auto-Update Fserves from Channel: This sets whether to scan messages from channels for Fserve ads. Default is on.

Check for Stats within Triggers: This toggles whether RFN checks for stats in Triggers (eg. Triggers: [!Trigger (1/10) & !Trigger2 (4/6)] ). The stats are saved as the values for the first "Fserve Sort Keyword" (by default, this is "Queues"). Turn this off to speed up processing. Default is on.

List Triggers: These are the recognized Fserve listing commands, separated by commas. The first one is the primary command. The others are recognized when you actually type them in channel windows. For mIRC commands, use ‹chan› to represent channel name as needed (eg. "/ctcp ‹chan› !List"). Default is "!list,!online".

List Timer: This defines the frequency at which RFN automatically sends the Fserve listing command for update of Fserve information. Minimum is 3600 seconds (1 hour). Set to below 3600 to turn off the timers. A timer is started (or restarted) only when you use an Fserve listing command (within RFN or manually typed). Default is off (0).

Trigger Keywords: These are the keywords (separated by commas and sorted by priority) that RFN scans in Fserve ads to parse for the correct triggers. These are also what RFN looks for when scanning messages to determine whether they are Fserve ads. If the keyword is at the end of the ad, RFN considers the trigger to be the first entry in the ad enclosed by parse opener and closer. Default is "trigger,[t®îggË®],FTP,« Ë×Çü®§îöñ »".

Parse Openers: These are the openers (separated by spaces and sorted by priority) used to parse Fserve ads. Information obtained this way is placed in the "Fserve Information" box. They are matched in position with the Parse Closers. The Default is "«« ( [ < { «". For example, in the partial notice "Fserve Triggers:(!This & !That)", the parse opener is ( and the closer is ).

Parse Closers: These are the closers (separated by spaces and sorted by priority) used to parse Fserve ads. Information obtained this way is placed in the "Fserve Information" box. They are matched in position with the Parse Openers. Default is "»» ) ] > } »".

Trigger Separators: These are the symbols that separate multiple triggers listed in an Fserve advertisement. Default is "& º •".

Parse Exclude Strings: This defines strings (separated by spaces and in order of priority) that RFN will skip when determining starting and ending of information during parsing of advertisements. Exclusions typically contain parse openers/closers that RFN normally would use for parsing. An exclusion can contain commas but must be at least 2 characters long. (eg. The trigger "!Trigger :)" can be parsed correctly if :) is in the Parse Exclude Strongs.) Default is ":) ;) =)".

Find Triggers: Find triggers are used to search for files on people's Fserves. Commands are separated by comma. Default is "@find,@locator".

Undisplayed Triggers: Messages on the channel that contain one of these strings at the beginning are filtered out if the "Suppress Triggers in Channels" option is on. Possible triggers include: away. Default is empty.

Displayed Triggers: Messages on the channel that begin with one of these strings are filtered but kept in memory. They can be viewed by pressing the "Show Displayed Triggers" button in "Status" tab. Default is "[Request],(Request),« Request »,«« Request »»,« Advert »,«« Advert »»,Timed Message".

Channels:

Open RFN after List: This sets whether the main interface window opens automatically after you use a recognized Fserve listing command in a channel. Default is on.

Auto-Join after List: This sets whether to automatically join the channel (if you're not on it already) after pressing the "List" button or double-clicking on a channel in the "Channel" listbox. If the channel window opens within 5 seconds, the current Fserve listing command will be sent. Default is on.

Clear Fserves on List: This toggles whether the Fserves list is cleared when an Fserve listing command is used. Turn it off if you're in channels that use more than one listing command (eg. !List and !Online). Default is on. The "Clear on List" checkbox in the "Channels" tab does the same thing.

Select Active Channel on Open: This toggles whether RFN automatically selects the active channel in the "Channel" list box (if available) when you open RFN. Default is off.

List Each Fserve as Single Entry: This sets whether RFN lists Fserves with multiple triggers as one entry in "Channels" tab. XDCC Fserve listings tend to clutter otherwise. Default is off.

Auto-Refresh Triggers List: This sets whether RFN will automatically refresh the Triggers list display under the Channels tab whenever a listed Fserve joins/parts the channel or quits IRC. It can be annoying if you're in the middle of something and it refreshes. Default is off.

List Unknowns on Top: This toggles whether RFN displays Fserves with unknown sort value (based on the "Fserve Sort Keyword" option) at the top (using symbol "?") or at the bottom (using symbol "y"). Default is on.

Track nick changes in: Cache, IQueue, File History: When an Fserve changes its nick, RFN automatically updates the cache, internal queue and file history. This may cause slow-downs if there are many entries. Uncheck the corresponding box if you do not want RFN to auto-update. Defaults are on.

Notify/Keep Symbols: These are the symbols (separated by space) used to show who are on your notify list and whose Fserve information is not to be updated. Default is "» «".

Mark Symbols: These are symbols (separated by spaces) that represent marked Fserves, and can be used to group Fserves together within a list. You can add as many symbols as you want (as many Fserve groups as you want). Default is "ø ×".

Fserve List Refresh Timer: This is the frequency in seconds RFN will check the list of Fserves in a channel to remove Fserves no longer present. Set to 0 to turn off automatic refresh. Maximum is 99999 (equivalent to 27.8 hours). Default is 900.

Fserve Info Keywords: This defines the type of information displayed in the Fserve information box under the "Channels" tab. Each heading is separated by a comma. This list does not include triggers. Besides the default ones, TimeZone, Running, and On Server are also common. Default is "Online,Sends,Queues,[Sends],[Queues],Bandwidth,Note".

Fserve Sort Keywords: This modifies how the Fserves are sorted. The default is "Queues,[Queues]". With the default, RFN sorts the Fserves according to number of queue openings. Fserves on your notify list take precedent. Those that have full queues have the symbol "x", and those that cannot be determined have the symbol "?" (or "y"). The symbols are repeated as needed for spacing purposes. Sorting is not only for queues. You can enter keywords such as Record CPS, Sends, Online and so on. Set this option to blank or uncheck the checkbox to turn off the sort. This option can also be toggled by the "Sort" checkbox in the "Channels" tab.

For x/y formats, sort by: y - x, x, y: There are 3 methods by which RFN can sort Fserves for x/y formatted information (eg. Queues: 3/10). For "y - x", Fserves are sorted by the second number subtracting the first (ie. 10 - 3). "Sorting by x" and "Sorting by y" sort the Fserves by the respective number. Default is x.

No List/Find Channels: This is the list of channels where you don't want to send Fserve listing and find commands. Format is "network1#channel1 network2#channel2". Default is none.

Fserves:

Use RFN for Navigation: This toggles whether RFN will be used for navigation of Fserves. Default is on. Cache is still created when off. If you turn off "Use RFN for Navigation" and have "Hide Fserve Window" on, "Hide Fserve Window" will be automatically set to minimize mode.

Auto-Focus to Fserves Tab: This toggles whether RFN will auto-focus to the "Fserves" tab when an Fserve is opened. Default is on.

Sort Files by Size: This toggles sorting of files on Fserves by size. Default is off.

Hide Fserve Window (grey for Minimize): When an Fserve is first opened, RFN hides the DCC Chat window if this option is turned on (minimizes if it is grey). Default is on. If you turn on "Hide Fserve Window" and have "Use RFN for Navigation" off, "Use RFN for Navigation" will be automatically turned on.

Close Fserve Window on Quit: This sets whether the DCC Chat window is closed when you quit the Fserve. Default is on.

Fserve Welcome Popup: This toggles whether a window pops up with the Fserve welcome message when connected. Default is on.

Anti-Idle: This sets whether to automatically use the CD command in an Fserve when the Fserve gives the "Closing idle connection" warning. It is recommended to leave this option off because it may annoy the Fserve owner. Default is off.

Auto-Stop Welcome Message: This sets whether RFN sends the "S" command (stop) rather than the "C" command (continue) when the Fserve sends a long welcome message. Default is off.

Single-Click Navigation: If this is on, single-clicks will change directories on Fserves rather than double clicks. Default is off.

Auto-Send Dir Command: This toggles whether RFN automatically sends the "Dir" command when opening an Fserve or entering a directory. Default is on.

Fserve Cache: This sets whether RFN saves an Fserve's directory structure to cache in memory as you browse. Default is on.

Keep Cache Between Sessions: This toggles whether RFN keeps the directory cache of an Fserve between Fserve sessions. The cache is lost when mIRC is closed. Default is on. You can also explore the cache in the "Cache" tab.

Search Paths in Cache: This sets whether RFN searches the path names when you do a cache search. Default is on.

No Response Delay: This is the number of seconds RFN waits for a response from an Fserve during directory listing and after sending "C" or "S" for long messages. Default is 15.

Fserve Recognition: This lists strings that RFN checks for when a DCC chat opens to determine if it's an Fserve. Wildcards (* and ?) are allowed (with ?, a character must be present to match). Default is "[Oßsidian] fileserver for X-Chat*" and "Welcome to Brunnis*".

Ignored Fserve Messages: This lists messages that RFN will ignore rather than analyze for being files, directories, etc. Wildcards (* and ?) are allowed (with ?, a character must be present to match). Default is "Please wait...".

Queue/Send Replies: This lists messages that RFN will recognize as queuing/sending replies from the Fserve. Wildcards (* and ?) are allowed (with ?, a character must be present to match). Default are "Queuing *", "Queued *", "Sending *", "Adding * to queue*" and "Instasending*". If you find an Fserve using an unrecognized reply, it is important to add it to "Queue/Send Replies" so RFN will recognize it. Otherwise, the file history and internal queue will not be processed correctly.

Queue Exists Replies: These are replies from the Fserve after you try to get a file that is already in queue. Default are "*Queue already exists*" and "*file is already in*".

Invalid Command Replies: These are messages that are recognized as responses to invalid commands. If the command was "clr_queues", RFN will remind you that the File History may be wrong. Wildcards (* and ?) are allowed (with ?, a character must be present to match). Default are "Invalid Command" and "Invalid Command?".

Invalid File/Path Replies: These are messages that are replies to attempted access of invalid files and paths. Wildcards (* and ?) are allowed (with ?, a character must be present to match). Default are "Invalid File*", "Invalid Folder*", "* is not a valid file*" and "* does not exist*".

End of List: These are messages that are recognized as end of directory listing. Wildcards (* and ?) are allowed (with ?, a character must be present to match). Default is "End of List*".

Character Convert: RFN can convert characters in Fserve messages to specific letters. This function does not apply to directory listings. Check the box to turn on the feature. Select a letter and enter the list of characters to convert from (separated by spaces). Default is on.

Custom Fserve Commands: You can set up to six custom Fserve commands. These are commands that would be sent to the selected Fserve when you click on the command in the menubar (under "Fserve"). Note that custom commands are sent upon selection, regardless of whether the parameters described below return a value or not.

Example 1: The custom command to get the selected filename would be: get ‹file›

Example 2: For Fserves that use the !drive command to access multiple drives, the command would be: !drive‹prompt›

Files:

Log Queued/Received Files: This sets whether to track queued, failed and received files in file history. Default is on.

Show Time in File History: This sets whether to show the timestamps in file history. Default is on.

Continuous IQueue: This sets whether RFN tries to get the next file in internal queue after the previous is queued on or being sent by an Fserve. Default is on.

Continue IQueue on Send: This sets whether RFN begins the internal queue again when the Fserve starts sending you a file, provided you are not currently browsing the Fserve. Default is off.

Remove DCCAllow on Send: This toggles whether RFN removes a nick from the DCCAllow list when a file send from the nick begins (if no other files are queued for that nick). Default is on.

DCCAllow on Server Notice: This sets whether RFN automatically adds a nick to the DCCAllow list when you receive this server notice: [nick] has attempted to send you a file named [filename]. Default is on.

DCC Trust: This sets whether RFN will use mIRC's DCC Trust function by automatically adding Fserves to DCC Trust list when files are queued. An entry is removed when the Fserve begins sending the last queued file. Grey check to have RFN turn off DCC Trust when the list is empty. Note that DCC Trust is not the same as DCCAllow (mIRC auto-accepts files from users on the DCC Trust list). Turn it off if you cannot receive files with it on. Default is off.

Download to Path on Fserve: This sets whether to create and download to, for a given file, the same path found on the Fserve. For example, with this option checked, if your mIRC DCC get directory is "c:\myfiles\" and the file being received was under "\a path\" on the Fserve "ImAnFserve", RFN would create the directory "c:\myfiles\ImAnFserve\a path\" and download the file to that path. To have RFN only do this for files that are tracked in the File History, grey check the box. Default is on for all files.

Remove IQueue when Empty: If this is on, RFN will remove an internal queue from memory when it is empty. Otherwise, it will keep the entry, including its trigger and maximum queue slots. Default is off.

Max Queue per Fserve: This sets the default number of queues allowed per Fserve. This can be set individually in "IQueue" tab.

Min Size to Continue IQueue on Send (Mb): If the file being sent is smaller than this minimum size, RFN will not trigger the Fserve to process the internal queue but will wait and check the next file being sent. This is to prevent flooding the Fserve and channel with triggers when files are small. Minimum is 1 Mb. Default is 10 Mb.

IQueue Retry Timer: When an Fserve is closed with your file history queue empty but internal queue not empty, RFN will try to trigger the Fserve to get the file in a frequency set by this timer, up to a maximum of 8 times by default (a successful connection would reset the try count back to 0). Numbers lower than 900 would turn this option off. Default is 1800 (30 minutes).

Times to Retry Queuing when Empty Queue: This sets the maximum number of times to retry queuing from an Fserve when you have no files queued on it. Set to 0 for never automatically turning on the timer. Default is 8.

Times to Retry Broken Sends: When a send from an Fserve drops, RFN can try to connect to the Fserve if it's available and queue the send again. The Fserve is then closed automatically in 5 seconds. This option determines the number of times a send can be dropped and RFN would still retry getting the file. Default is 1. Set to 0 to turn off the option. "Log Queued/Received Files" option must be on for this feature to work. Close the mIRC "File Get" window within 5 seconds after the send was stopped if you want to cancel the send. Please refer to rfn-faq.txt for limitations of this feature.

Close Fserve Delay in IQueue: During automated internal queue processing, Fserves are closed in the specified number of seconds after the last "Get" command. 0 to turn it off. Default is 90 seconds.

DCCAllow Network and Size: This is the list of networks that use the "DCCAllow" command and each network's DCCAllow list size (separated by spaces). For example, if DALnet's DCCAllow list size is 5 and ExampleNet's is 10, you would enter "DALnet 5 ExampleNet 10". If you reconnect to a network within the same mIRC session, RFN tries to re-add the nicks in your DCCAllow list before your last connection. Default is "DALnet 5".

DCCAllow Extensions: This is the list of extensions that the "DCCAllow" command is used with (separated by spaces). Default is "zip exe com bat dll doc ini js lnk mrc pif pl scr shs vbs xls".

Add-Ons:

The RFN add-ons that are loaded in mIRC are shown in the "Loaded Add-Ons" listbox. Use the "Configure" button to configure the selected add-on (if configuration is available). The "Load" and "Unload" buttons load and unload the selected add-on respectively. If "Auto-Load Add-On Path" is set, RFN automatically loads any RFN add-ons that are in the specified path when mIRC initiates.

Back to How To Use


Help:

The rfn-faq.txt file is loaded here.

About: Please email comments and suggestions. Even a simple "thank you" is nice if you find the script useful. The link with my page address opens my homepage (http://adrian.saxtus.gr). Come visit! The "Help File" link on the right launches the help file rfndoc.htm. The License link launches the file rfn-license.txt.

Back to How To Use

Back to the top


NOTES:

Please read rfn-faq.txt for additional notes if needed.

Thank you for trying Ren-Ren's Fserve Navigator. Feel free to tell your friends about it. If you find RFN useful, please consider making a donation via PayPal. If you find a bug or think of a cool feature, you can send me an email at renx2@yahoo.com or tell me on DALnet IRC. I use the nick Ren-Ren.

For now, there is only one CTCP command the script responds to: RFN Version
The response is: RFN-Version [script name and version] [page address]

Back to the top


LICENSE AND DISTRIBUTION INFORMATION:

License Agreement: RFN is released as freeware. RFN may be distributed freely only in its entirety and as long as the files remain unmodified. RFN may not be sold or distributed as part of any product or package without express permission from the author. RFN is provided as is without warranties of any kind, expressed or implied. The author cannot be held responsible for any possible damage from the use of RFN. The user must assume the entire risk of using RFN.

I spent an enormous amount of time and energy on this. Please don't copy the script or any of its portions and call it your own.

RFN and all materials included in the package Copyright© 2000-2002 by Adrian Au. All rights reserved.

Back to the top


3ACC26C2 4BF792C8