The AutoGet plugin can automatically request sounds from other people in chat when they play sounds that are not in your AutoGet folder. IRCmagic supports most types of sound files encountered on IRC.
The AutoGet plugin also offers incoming DCC file handling features such as reporting information about DCC file transfers, and keeping track of incomplete downloads via Finder labeling.
To enable or disable this feature, type the following into any Ircle window, or click the Settings button in the IRCmagic Main Window.
/autoget on
/autoget off
To change AutoGet settings, type the following into any Ircle widow, or click the appropriate button in the IRCmagic Main Window.
/autoget
IRCmagic displays the following window:
As you can see, IRCmagic's AutoGet functions are fully configurable. Here is a description of each of the items in the AutoGet Setup window:
AutoGet Message
This message is automatically typed any time IRCmagic sees someone play a sound you do not have. The default message uses special tags that are replaced with relevant information whenever the message is used. For more information, see How Custom Messages Work.
AutoGet Folder
This section displays the folder where AutoGet looks when receiving a CTCP SOUND message from another person in chat. If the sound is not found in this folder, AutoGet will request it. Click the Set button to change the folder. Click the Clear button to clear the folder.
Display a dialog asking if I want to request each sound
If this checkbox is enabled, AutoGet will display a dialog box each time a CTCP SOUND message is received and the sound is not found in your AutoGet folder asking if the sound should be requested. The dialog box will look similar to this:
AutoGet File Filter
When Use File Filter is checked, IRCmagic filters sounds being played, and only requests files that match the criteria specified. You can instruct IRCmagic to filter the following types of files: .wav, .mid, .mp2, .mp3, .mod, and System 7. (System 7 files are a special case - IRCmagic looks for either no filename extension, or for .snd.)
For each file type, IRCmagic looks at the 3-character extension at the end of the filename to determine if the file should be requested. If a match is made, the file is requested. If not, the file is ignored.
You can also specify your own custom type to filter by entering text into the Custom edit field. This contents of this field is used as a regular expression to match the full or partial name(s) that you want to look for. You are not limited to entering just a 3-character extension into this field. This field can contain anything you want to filter. Example: As a complex example, you could supply (nin)|(nine*.inch*.nails*.) if you wanted to automatically request any sound files with nin or nine followed by any character(s), followed by inch, followed by any character(s), followed by nails.
When the Do not request sounds if AutoGet drive is __ full box is checked, IRCmagic checks the amount of free space on the drive selected as your AutoGet drive any time someone plays a sound you do not have. If more space is used your hard disk than is indicated by the pop-up menu, IRCmagic will ignore sounds that are playd in your presence.
If the Show "ignored" message when files do not match option is checked, IRCmagic displays the corresponding message in the current window whenever a file does not match your settings.
File Handling
The File Handling section of the dialog box allows you to instruct IRCmagic on how to handle the files it retrieves with AutoGet. If Label files when DCC is incomplete is checked, IRCmagic marks (or labels) files with the selected label when the transfer is interrupted and the file is incomplete. The label pop-up menu to the right of this checkbox reflects the numeric index and text of each of the seven labels on your system.When a file is completed, the label is automatically reset to "None".
Note: You may edit label color and text by switching to the Finder, choosing Edit > Preferences..., and then choosing the Labels tab in the resulting dialog box. IRCmagic's label pop-up menu reflects your changes.
If Request (resume) labeled files when they are played is checked, IRCmagic does not include files with the selected label in it's internal file lists. Therefore, when one of them is played, it is not found in the list, and is automatically requested if AutoGet is enabled. Checking this box also enables ircle's Auto DCC Resume setting, which can be found in Ircle's DCC preference panel.
Note: IRCmagic cannot discern between files IRCmagic labels and files you manually label in the Finder. Any files with a matching label are effected.