Quick Start
Ok, this is a very short description of how to search and work around with the software.

1. First of all, type your search string in the obvious search text box... :)
2. Now hit search button, this will change it to a stop botton and will start the search query.
3. As the search goes on, engine names will be listed in the results list.
4. Now to check out the results, double click the desired search engine to expand the list.
5. When you find what you need, right click and choose one of the presented options, "Connect" will use the FTP client that you chose to connect to the server and go to the directory selected, "Get File" will connect and try to automatically get the file (won't work if server is ratio), "Delete" does its obvious thingy, "Copy Location" will copy the whole url that you need to the clipboard so if you desire to use a different FTP client...

Settings
The "Settings" box will allow you to do 3 things

1. The General settings:
   Max Search Sockets at a time: This is where you specify how many search engines you want to search AT THE SAME TIME, the better your connection is, the better you can handle this, on my ADSL, i search easily 10 at the same time, on a 56k i would recommend 3 max so that you can browse and do other things while this searches.
   Max Test Sockets at a Time: This is where you specify how many sockets you want to deploy to test the returned results, just like its predecessor, the better your connection, the more you can have.
2. The Proxy settings:
   You need to enter any proxy server (HTTP) that your ISP might force you to use, if none exists, better, leave this empty.
3. Client Settings:
   Local Directory: This is the directory to which the chosen FTP Client will goto on startup and download/upload files from.
   Now the new option here will allow you to add, edit and delete as many FTP clients as you like, to learn more about this feature, read "FTP Client Setup".
4. Hit save to Done your settings and go back to the search.

Engines List
Ok this is very simple and easy, all you do here is decide whether you want to use the search engine or not.
The new thing that was added here is the ability to ADD your own engines and update the ones that are already there, double click on an engines name to fill in the boxes with its current info, change it and press update to update/add new engines.
The only tricky part here is the Query string, you have to know how to call the search engine and replace the search string with %s, if you have any problems with this, email me
In release 2.1+ if you omit %s from the Query string, then the engine will be considered as a Top Charts engine and will be browsed for mp3 links

Back to Index

Test Options
The neat stuff:

1. Test Results: when this is checked, whenever a new ftp server address is returned, it will be tested to see if the link is dead.
2. Re Test Results: will redo the test.

FTP Client Setup
This is a bit tricky if you don't know what you're doing, first of all, you have to check the client you want to add and learn how you can make it start and connect automatically, usually there are two types of clients, those that will run simply with a command line argument and those who need script files, both are supported.
Now when you have decided what your client needs as arguments and if a script file is needed, proceed into writing the argument line into the "Command Line Args" box, for example, suppose your client can be called from dos like this "myclient host=ftp.testing.com port=21 user=myusername pass=mypassword" and any other things you need to pass, then you will need to change some things in this line, Everything that is a variable, ie that you expect my program to send to the server must be changed into %# where # is a character as follows:
%h = hostname (ip address of ftp server)
%o = port
%u = username
%p = password
%l = local directory to start in
%r = remote directory to start in
%f = filename
Now, as have seen, there are two options to connect to a server, you either connect only, or you connect and download the file, so for anything that has to do with downloading a file, you need to keep it inside "[file download related]", now for scripts, it's the same thing, except when you need to go to a new line, you just do it :), also in a script, each line that is related to download files has to be inside "[ ]" by itself, ie you can't put multiple lines together
I hope this helped, if not, you can take a look at the already implemented clients and see how they were done, if that still doesn't help, email me :)

Back to Index

Update Options
Three types of updates, all can be found under Help

1. Check for upgrade: this will contact the homepage and check if a newer version is available, if so, you will be told so, and all you have to do is click on the text to start download with your default browser.
2. Update Engines: As it sais, this will check to see if new engines have been added and will download them and add them to your list if you desire to do so, when the list is retrieved it is displayed in a list, just uncheck the engines you do not with to update/add.
3. Update Clients: As Update Engines, this updates any new clients that are added.

Top Charts Search
This option is new from version 2.1 and over, it allows you to check Top Charts pages for their mp3 links directly within the program instead of going to them each one at a time in your browser, after having downloaded the charts you desire, double click on the song you want to download and a window will open and ask you where you want to put the song and will start downloading it...
If you need to add/delete engiens in this section, it is the same as for the normal search, refer to Engines section in the documentation for more help on that part.

Back to Index