Contents
   GetRight Help Contents

www.getright.com

Using GetRight:

   Getting Started with GetRight

   Controlling Downloads on the Download Status

   Configuring GetRight

   Tray Icon Menu Options

    Paying for GetRight

Problems and Tips:

    "How do I ... ?" and Frequently Asked Questions

    Things to try if GetRight doesn't work (and some known bugs/features)

    Hints, Tips, Notes, Developer Info and Advanced features.

Other Information:

    Key Features of GetRight

    Why should I use GetRight?

    Requirements to run GetRight.

    New Features in 3.3.x

    Paying for GetRight

    Contacting HeadLight Software

Help File Version 3.3.3   About GetRight


GettingStarted
Getting Started with GetRight

GetRight is a tool to help you download files from the Internet.

While GetRight has many options to let you set it up to work how you want it to work, for starters, it is easiest to leave the default settings alone.

Starting Downloads:  GetRight will plug into your web browser (any version of Netscape Navigator and Microsoft Internet Explorer 4.0 or higher) so that starting downloads with GetRight is as easy as clicking in your web browser.  When you click on a file to download, GetRight will take over and show its own "Save As" window and Download window.  (If you use a different web browser, there are other methods to have GetRight start downloads.)

Resuming Downloads:  If a download stops for any reason, you can easily resume it with GetRight.  If the download window is still showing, just press the "Resume" button.  If it is no longer showing (such as if your computer has been shutdown), just double-click on the GetRight logo in your Windows tray icons to open the Download Status window.   Then double-click the download from the list of all your downloads to resume it.

More Advanced Features:  Nearly all of the more advanced features are available from either the Download Status (to get there, just double-click on the GetRight logo in your Windows tray icons) or the Configuration window (to get there, just right-click on the GetRight logo in your Windows tray icons, and pick "Configuration" from the menu).


NewFeatures
New Features!

New in 3.3.x

•	Major speed improvements.  Adding a new download and other things are much faster.

•	FTP Search.  GetRight will now perform searches using FTP Search sites to find other addresses where a file may be downloaded.

•	Enhanced and added more items to the Web Page Processor.

•	Added a button in the titlebar of the individual download windows to minimize to the tray icons.

•	Added more scheduled hanging up options.

•	Added When Done configuration tab so you can setup file types that should be scanned for viruses, and file types to be opened.

•	Added to the Limits configuration tab so you may limit the number of downloads from the same server at the same time.

•	Re-recorded the sounds for better quality.

•	GetRight 3.3 also fixed some bugs and made not easily visible enhancements.

Older new features:  (These were new in 3.2):

•	Configuration Wizard to make setup of some options easier.

•	Basic and Full modes.  The new Basic mode hides many of the advanced options to make it simpler for users who just want to download files without all the fancy extras.

•	Enhanced "Save As" window--makes it even easier to recover lost downloads and to add comments.

•	Speed up some things:  Adding a new file to be downloaded is much faster. Refreshing the Download Status should both now be both faster and less often.

•	"Enter New URL" now has a dropdown list that contains the last URL that was started, as well as the last 10 URLs you typed in.

•	Show the individual download windows as tray icons.

•	You can now edit more options for the appearance of the Download Status toolbar.

Notes about all changes may be found in the HISTORY.TXT file or at http://www.getright.com/history.html


T_222054060056
FTP Search

Much like many of the common sites that let you search the web for information, there are several sites offer "FTP Searching" to allow you to search for a specific file on different FTP servers.  GetRight will now use these FTP search sites to find more alternate addresses where files may be downloaded.

You may pick which server to use for FTP searches, as well as calculate the fastest server for you to use, on the File Mirrors configuration tab.


HowDoI
How do I ... ?

•	Also try the web version of these questions--they are updated more frequently and has many more items.

http://www.getright.com/howdoi.html

•	How do I start downloads with GetRight?

•	I have my registration number, where do I enter it?

•	How do I resume downloads I have started?

•	How do I register and remove the Shareware Reminder windows?

•	How do I schedule downloads for later?

•	How do I get the schedule/disconnect/dial buttons to be enabled?

•	How do I download one file after another?

•	How do I setup the different sound files included in GetRight?

•	How do I have GetRight always resume downloading when I connect to the Internet?

•	How do I have GetRight continue a download started with some other program?

•	How do I get to the advanced functions?

•	How do I Not download something when I click a link (such as a search site)?

•	How do I setup GetRight with a Proxy server?

•	How do I save and restore GetRight's settings if I am going to re-install windows?

•	How do I download all the files on a web page?

•	How do I download files that need a username/password?

•	How do I create a file with a list of files for GetRight to download?

Frequently Asked Questions

•	Also try the web version of this FAQ--it is updated more frequently and has many more items.

http://www.getright.com/faq.html

•	Problems with GetRight's integrating with Netscape?

•	Problems with Netscape after moving/deleting/uninstalling GetRight?

•	Issues with Windows98?

•	Using earlier versions of GetRight?

•	Occasional lockups or crashes?

•	GetRight Locks up downloading from just some sites.

•	GetRight downloads slower than other programs.

•	No servers resume downloads for me.

•	Windows runs out of resources if GetRight has to re-connect many times to finish a download.

•	I get the error "address not supported by protocol family".

•	I get the error "cache detected error".

•	I get the error "S32STAT.DLL not found" when GetRight finishes downloads.

•	My mouse is very "jumpy" when downloading with GetRight.

•	I use America Online and I am getting errors connecting with GetRight.

•	How can I set Download.Com to use/not use GetRight as its download manager?

•	How can I use a .ZIP file I downloaded if I don't have a ZIP drive?

•	I'm a site administrator, how do I get my site to support resuming?

•	How can I use GetRight with Microsoft's programs that use Active Setup?

•	The Enter Code buttons are disabled so I can't type in the registration code.

•	What FTP and HTTP servers allow download resuming?

•	I hate the tray icon logo.

•	Getting more help.

For many of these items, you may use use the configuration form to setup a streamlined method to perform the action.   If the step may be streamlined, a link to the appropriate configuration tab (or other help topic) will be shown after the text in curly brackets with a brief description of how it may be improved {xxx}.

----------How do I ... ?----------

How do I start downloads with GetRight?

•	 See here.

(Back To Top)

How do I resume downloads I have started?

•	 See here.

 (Back To Top)

How do I register and remove the Shareware Reminder windows?

•	 See here.

(Back To Top)

How do I schedule downloads for later?

 •	>>> This requires you to be in FULL mode.

•	Once you have started a download and the download is in progress, click "Cancel".  Click "Yes" on the prompt to say you want to resume it later.

{advanced tab: have GetRight prompt to start now or later}

•	After you have added as many files as you want, go to the Download Status window (normally, double click on the GetRight logo in the tray icons, or see here for other ways to get a menu to pick "Show Download Status".)

•	On the Download Status window, click the [image] toolbar button to show the schedule window.  Pick the time when GetRight should start the download.

•	Leave your computer and GetRight running.

{internet tab: have GetRight dial at the scheduled time}

{download status: have GetRight hang up or shutdown the computer when done}

(Back To Top)

How do I get the schedule/disconnect/dial buttons to be enabled?

•	>>> This requires you to be in FULL mode.

•	For features that require GetRight to dial your modem, you must have setup your modem and Internet connection information on GetRight's Internet configuration tab.  This includes the Schedule Downloads, Schedule Hang Up, Hang Up When Done, and Reconnect if Disconnected features on the Download Status window.

(Back To Top)

How do I download one file after another?

•	On the Limits configuration tab, you may set the number of downloads to do at once.

•	After you have the downloads you want in GetRight's list, turn on "Automatic" downloading on the Download Status.  When one download finishes, another will be started (up to the limit you set for downloading at the same time.)

•	In "Basic" mode, as long as no errors occur, when one file finishes, GetRight will start the next one.

(Back To Top)

How do I setup the different sound files included in GetRight?

•	GetRight includes several sound effects for use in GetRight.  The GetRight Configuration Wizard can setup several of these sounds for you to use.

To setup sound files yourself:

•	>>> This requires you to be in FULL mode.

•	Go to the GetRight configuration window.  (Right click on the GetRight logo in the tray icons and pick "Configuration" from the menu that appears.)

•	In the middle of the "General" tab is a list of different actions in GetRight (and these actions are defined here).  Pick one of these, then click the "Browse" button.  Unless you installed GetRight somewhere else, go to:

"C:\ProgramFiles\GetRight\Sounds\" and pick the appropriate sound for the action.  (The README.TXT file in the "sounds" directory contains several suggestions.  Not all actions have sound files included.  And you can use any other .WAV sound file you want.)

(Back To Top)

How do I have GetRight always resume downloading when I connect to the Internet?

•	Check the "Always start automatic downloading when connected" on the Internet configuration tab.

•	And the GetRight Configuration Wizard asks about this.

(Back To Top)

How do I have GetRight continue a download started with some other program?

•	 See here.

(Back To Top)

How do I get to the advanced functions?

•	>>> Many of these require you to be in FULL mode.

•	All the advanced options in GetRight are found on either the Configuration or Download Status forms.

To get to the Configuration form, Right click on the GetRight logo in the tray icons and pick "Configuration" from the menu.

To get to the Download Status form, Double Click on the GetRight logo in the tray icons.

•	Also see here for some advanced tips.

(Back To Top)

How do I Not download something when I click a link (such as a search site)?

•	>>> This requires you to be in FULL mode.

•	Some sites (such as some search sites) use URLs that GetRight things are files so it will try to download the "file".

•	When GetRight is integrated into either Netscape or Microsoft web browsers, if you hold the SHIFT key down when clicking a link, GetRight will not try to get the link (even if it is a type that GetRight would normally handle, such as .EXE.)

Also, if you hold both the CONTROL and ALT keys down when clicking a link, GetRight will always get the link (even if it is a type that your web browser would normally handle, such as .HTML.)

•	You may create a list of servers that GetRight should always ignore when doing click monitoring.   See the Monitor configuration tab.

(Back To Top)

How do I setup GetRight with a Proxy server?

•	All the Proxy setup options are on the Proxy configuration tab.  A subset of these settings is also in the Configuration Wizard.

•	If you have setup your web browser to use Proxy servers, you should just have to click the "Find" buttons to get the correct values.

•	Getting GetRight to resume downloads with Proxy servers may take a bit more setup.  There is more information here on getting a Proxy server to resume downloads (not all Proxy servers will allow GetRight to resume downloads).

(Back To Top)

How do I save and restore GetRight's settings if I am going to re-install Windows?

Saving list of files being downloaded:

•	>>> This requires you to be in FULL mode.

•	You may save the list of files to be downloaded by selecting files on the Download Status window and using the Import and Export functions under the File menu.

•	This also works to transfer downloads between more than one operating system running on the same computer--such as Windows 95 and Windows NT.

•	GetRight (3.2.1 and higher) stores these downloads in a GETRIGHT.INI file in the directory where GetRight is installed.  If you save this file, you may restore it after re-installing.

Saving all the other settings:

•	There is no simple way to save all your other GetRight settings.  But you may use a registry editor to do this (this should be done only by knowledgeable users.)

To Export:

•	Select the registry key HKEY_CURRENT_USER\Software\HeadLight\GetRight

•	Pick "Export Registry File" from the Registry menu.

•	Remember the file name and move the it someplace it will not be deleted by re-installing Windows.

To Import:

•	Pick "Import Registry File" from the Registry menu.

•	Select the file you exported earlier.

(Back To Top)

How do I download files that need a username/password?

•	In FULL mode, you can setup usernames and passwords for servers you use often on the Login Configuration tab.

•	In FULL mode, you may set the username and password for any existing downloads on the Download Status window.  Use the "Change Username and Password" item under the Advanced n FULL mode, you may set the username and password for any existing downloads on the Download Status·	In FULL mode, you may set the username and password for any existing downloads on the Download Status window.  Use the "Change Username and Password" item under the Advanced menu.

•	GetRight will also accept URLs with the format:

ftp://username:password@ftp.xyz.com/...

http://username:password@www.xyz.com/...

NOTE:  GetRight will have trouble getting the correct username and password from these formats if your username or password contains the characters:  / or @ or :  To avoid problems, don't use those characters in your usernames or passwords.

(Back To Top)

 How do I download all the files on a web page?

•	 If you download a web page (HTML) with GetRight, it will ask you about parsing the page to find all the links on the page.

•	If you say Yes, you will be shown a window so you can select which files to download  (This is GetRight's Web Page Processor.)

•	NOTE:  this function is only available for registered users.

  (Back To Top)

How do I create a file with a list of files for GetRight to download?

GetRight accepts 2 different formats for a list of files to be downloaded.  Once you have created one of these files, you may use the command:

GETRIGHT FileNameOfList

to import the list of files to download.

xxx.LST

•	This is a very simple file format--one URL per line.  GetRight will prompt you for where the file should be saved (unless you have setup defaults using the "Save To" configuration tab.)

xxx.GRX

•	The file format used by the Import/Export functions may also be used.  This allows you to tell GetRight where to save the file, alternate addresses for the file, and some other things.

•	File Format:

// xxx      -- Comment line; ignored.

URL: xxx    -- URL to be downloaded.

File: xxx   -- Local path and filename for the file.

Desc: xxx   -- Description to use for the download.

Alt: xxx    -- Alternate URLs for downloading (may be up to 16).

                 And should contain the value of the URL item as

                 one of the Alt values.

•	Each 'name: value' pair should be on its own line.

•	The URL value should be the first item in each group.  Other items (such as File) following the URL value will be used for that URL until the next URL value is found.

If you use the "Export" under the File menu on the Download Status, the exported file will also contain this text that describes the format.  (And will be a good example of this file format.)  You may also use the "Import" item to open a file of this format.

  (Back To Top)

----------Frequently Asked Questions----------

Problems with GetRight's integrating with Netscape?

•	Some Netscape users have had problems using Netscape after GetRight 3.x has been installed and has integrated with the browser.   The GetRight 3.1 setup program has been enhanced to give you the option to integrate or not, detect and fix your computer if you may be having problems, and includes instructions on fixing it if you have problems.  You may also find help at http://www.getright.com/ungetright.html

•	See also this item.

 (Back To Top)

Problems with Netscape after moving/deleting/uninstalling GetRight?

•	Symptoms are that Netscape (4.04 or earlier) doesn't ever open any web page you type in or select from your bookmarks.

•	Netscape 4.05 does fix this problem.

•	If GetRight is moved, deleted, or incorrectly uninstalled, it can not update the settings used to integrate into Netscape.  Netscape (4.04 or earlier) then has problems because it can't find the GetRight files used to integrate (Netscape doesn't ever open any web page you type in or select from your bookmarks.)

•	If you run the GetRight setup program, it will detect and fix this problem.

•	You may also download http://www.getright.com/fix_nscp.zip  Run the fix_nscp.reg file in that ZIP file to remove the settings from Netscape.

•	You may also use a DOS prompt, switch to the directory where GetRight is installed and use the command:

GETRIGHT /NONS

•	Or to do this by hand, the registry settings to remove are:

[HKEY_CURRENT_USER\Software\Netscape\Netscape Navigator\Automation Protocols]

http=	<<delete value>>

ftp=	<<delete value>>

And the GetRight setting that tells it to do the click monitoring:

[HKEY_CURRENT_USER\Software\Headlight\GetRight\Config]

WatchBrowser=00000000

•	NOTE:  Microsoft Internet Explorer does not appear to have problems if GetRight is moved/deleted.  But GetRight's click monitoring will no longer work.

  (Back To Top)

Issues with Windows98?

•	Windows Update:  If click monitoring is turned on for Internet Explorer 4.0, then GetRight will take over some, but not all, downloads started by the Windows Update utility.  For those that GetRight takes over, it causes errors from the Windows Update utility.  But the file should download fine within GetRight.  (WHY:  Some of the update files are normal .EXE files, while others are different types that don't trigger GetRight.)

If the update file is downloaded by Windows Update, it will automatically be run to install the update after it is downloaded.  GetRight does not perform this step, and you must run the file yourself to install it.

•	Save As Window On Top:  This is fixed in GetRight 3.2, but is an issue for earlier versions of GetRight.  With GetRight 3.1 or earlier, the Save As window does not come to the front as it did in Windows95 and may require you to minimize other windows to find it.

 (Back To Top)

Using earlier versions of GetRight?

•	GetRight 3.2 and earlier stores the list of files to be downloaded in a different location than GetRight 3.3 and higher.

GetRight provides some command line commands to upgrade or downgrade the download list for use with earlier versions of GetRight.

From a DOS prompt, run

GETRIGHT /DOWNGRADE

to save the download list for use with GetRight 3.2 or earlier.

GETRIGHT /UPGRADE

to merge the download list from GetRight 3.2 or earlier into the current list.

 (Back To Top)

Occasional lockups or crashes?

A small number of people have had GetRight lockup or crash.  While the causes of all the occasional lockups and crashes are not known, some known causes:

•	Using Luckman's Anonymous Cookie or possibly other anonymous cookie tools.  Try on the Advanced configuration tab in GetRight, turn off the "Use Cookies from web browser" item.  This has fixed these lockups for some people.  (GetRight now will detect if you have Luckman's Anonymous Cookie and will prompt you about turning this off.)

•	Using Nuts & Bolts.  Try turning off Nuts & Bolts and see if that fixes it.

•	Using Matrox video cards.  Try changing the color depth (especially to something other than 24-bit color) or screen resolution--these have helped some people.  Matrox video card users have also experienced "jumpy" mouse movements.  Changing color depth seems to improve that one too.

•	A very odd one actually crashes in Microsoft Internet Explorer.  Some people have had odd crashes in IE, especially clicking the "Back" button.

It has fixed this for several people by:  in Internet Explorer, pick the "View" menu, then "Internet Options...".  In the "Temporary Internet Files" box, click the "Settings" button.  Change the check for newer versions of stored pages from "Every time you start Internet Explorer" to "Every visit to the page".

  (Back To Top )

GetRight Locks up downloading from just some sites

•	See above.  It may be the Luckman's Anonymous Cookie item.

  (Back To Top)

GetRight downloads slower than other programs.

•	If you have used TweakDUN, or other similar programs which are supposed to speed up your transfers, they seem to have the opposite effect in GetRight.  Try disabling them or reverting to the original settings and see if that helps.

•	Windows 98 can also do this itself.  Try going into your Control Panel and open "Network".  Click on "Dial Up Adapter" then the "Properties" button.  Click on the "Advanced" tab, and select "IP Packet Size" change this value from "Automatic" to "Small".  Click OK and reboot as needed.

 (Back To Top)

No servers resume downloads for me.

•	Not all servers support resuming (but more and more are.)  And if you are using a Proxy server, they can cause no servers to resume--some older ones don't know anything about the resuming features GetRight is using.  You can sometimes play with the proxy settings (there are some things to try listed here) and get resuming to work, but you may have to have the proxy server upgraded to get resuming to work.

 (Back To Top)

Windows runs out of resources if GetRight has to re-connect many times to finish a download.

•	While not necessarily the only cause, you may want to get this updated KERNEL32.DLL from Microsoft that fixes a Windows95 memory leak when making many network connections.  (You don't need this if you have WindowsNT, Windows95 OSR2, or Windows98) The file:

http://support.microsoft.com/download/support/mslfiles/KRNLUPD.EXE

and Microsoft's Description of this file and the problem:

http://support.microsoft.com/support/kb/articles/Q148/3/36.asp?PR=W95&FR=0&M=F

 (Back To Top)

I get the error "address not supported by protocol family".

•	This is most often caused by using Trumpet winsock with GetRight.  There is some incompatibility so that GetRight does not work with Trumpet.  You can try using a different network connection software (the Windows Dial-Up Networking that comes with Windows95/NT has worked great with GetRight.)

•	This may also be caused by using GetRight with America Online 3.0 for Windows instead of America Online 3.0 for Windows95.

 (Back To Top)

I get the error "cache detected error".

•	Try turning off the "Use alternate connect..." item on the HTTP proxy configuration tab, or changing the "CONNECT address" to "User with no login" on the FTP proxy configuration tab.

•	You can also try changing the "Tell HTTP Proxy server to not use caches." option on the HTTP proxy configuration tab.

 (Back To Top)

I get the error "S32STAT.DLL not found" when GetRight finishes downloads.

•	This is from Norton AntiVirus (which you're having GetRight use to scan for viruses when it finishes downloads).

•	Search for that file on your hard drive, and copy it to the same directory where the virus scanner EXE file is located.

•	(The GetRight virus scanner is setup on its 026 Advanced configuration tab.)

 (Back To Top)

My mouse is very "jumpy" when downloading with GetRight.

•	This appears to be at least partly related to using the Matrox Millenium II video card.  Try changing the color depth or resolution of your screen.  People have reported more problems with 24bit color than others.

•	While not guaranteed to work for everyone, it has helped some people to switch mouse drivers from "Standard PS/2 Port Mouse" to use the "Microsoft PS/2 Port Mouse" driver.

To change drivers in Windows, use WindowsStartButton-> Settings-> Control Panel-> Mouse-> General Tab.

 (Back To Top)

I use America Online and I am getting errors connecting with GetRight.

•	You will need AOL 3.0 for Windows95 (or higher) instead of just AOL 3.0 for Windows in order for GetRight to work.

 (Back To Top)

How can I set Download.Com to use/not use GetRight as its download manager?

•	If you re-run the GetRight setup program, it asks whether or not to make Download.Com use GetRight as its download manager.

•	You may also use a DOS prompt, switch to the directory where GetRight is installed and use the command:

GETRIGHT /DLM  to set to use GetRight as the download manager for Download.Com.

Or use the command:

GETRIGHT /NODLM to set Download.Com to use no download managers.

 (Back To Top)

How can I use a .ZIP file I downloaded if I don't have a ZIP drive?

•	.ZIP files don't really have anything to do with Iomega's ZIP drives.  ".ZIP" means the file was compressed to make it smaller so it takes less time for you to download.  You will need an "unzipping" program such as WinZip (www.winzip.com) to uncompress any .ZIP files you have downloaded.

•	And for you more computer literate; Yes, this question really is asked fairly frequently :-)

 (Back To Top)

I'm a site administrator, how do I get my site to support resuming?

•	GetRight uses abilities built into most FTP servers and most newer HTTP servers--there's no special server software needed for GetRight.  You will probably only need to get the latest version of your web/ftp server software (For HTTP, Apache servers >=1.2, Microsoft IIS >=3.0 and Netscape servers >=2.0 all resume great.)  See http://www.getright.com/servers.html for a bigger list of server software that is known to resume/not resume.

 (Back To Top)

How can I use GetRight with Microsoft's programs that use Active Setup?

•	It is possible (well, it has been done at least once) but it is for the Expert user Only!  See http://www.getright.com/active.html for instructions.

 (Back To Top)

The Enter Code buttons are disabled so I can't type in the registration code.

•	This is because someone used one of the "pirated" registration codes that have been illegally posted on the Internet.  After you have legally registered (using one of the methods listed here) contact mjb@headlightsw.com -- include the name and email address you used to register to speed up getting help.

 (Back To Top)

What FTP and HTTP servers allow download resuming?

•	See http://www.getright.com/servers.html for the most current list of servers that are known to allow resuming or not allow resuming.

 (Back To Top)

I hate the [image] tray icon logo.

•	There are a couple options:

On the Advanced configuration window, you can select from among several pre-defined icons.

Or if you know about editing the registry, you can set GetRight to use any icon (.ICO) file you want.

 (Back To Top)

Getting more help.

•	You may read the online version of these Frequently Asked Questions.  They will be updated with more current questions and answers as needed.  http://www.getright.com/faq.html

•	See contacting Headlight Software.


CacheErr
Error "cache detected error".

•	This is usually caused by your proxy server settings not quite being correct.

•	Try turning off the "Use alternate connect..." item on the HTTP proxy configuration tab, or changing the "CONNECT address" to "User with no login" on the FTP proxy configuration tab.

•	You can also try changing the "Tell HTTP Proxy server to not use caches." option on the HTTP proxy configuration tab.


T_222054060052
Overwrite, Resume, Cancel

Overwrite button:  start the download from the beginning.  The current file on your hard drive with that name will be deleted.

Resume button:   Resume the download, starting at the end of the file on your hard drive.

Cancel button:  Go back to the Save As window.


AddressNotSup
Error "address not supported by protocol family".

•	This error is most often caused by either using AOL 3.0 or Trumpet winsock with GetRight.

•	Trumpet:  There is some incompatibility so that GetRight does not work with Trumpet for everyone (but it does work for some people).  You can try using a different network connection software (the Windows Dial-Up Networking that comes with Windows95/NT has worked great with GetRight.)

•	AOL:  You will need AOL 3.0 for Windows95 (or higher) instead of just AOL 3.0 for Windows in order for GetRight to work.


Key Features

•	Easy to use.  Integrates into both Netscape Navigator/Communicator and Microsoft Internet Explorer (4.0) to automatically download your files using GetRight.

•	Easily resume downloads that have been disconnected--from both HTTP and FTP addresses.

•	Easily see details about download (size, speed, time left).

•	Built in dialer (with redialing.)

•	Schedule downloads to start at a specific time (such as late at night when phone rates are cheaper.)  And you can set a re-occurring scheduled time (such as to download every weekend evening or when phone rates are cheapest).

•	Schedule stopping downloads and hanging up the modem at a specific time (such as in the morning when phone rates go back up.)

•	Hang up your modem when done downloading.

•	Shutdown your computer (or Windows) when done downloading.

•	Automatically redial and continue if disconnected while downloading.

•	Set a speed limit to not hog the modem and let you keep browsing.

•	Can automatically calculate and track alternate addresses for a file, and then Ping the servers to find and automatically switch to the one that should offer the best performance for downloading.

•	Download Status window that shows a dynamic report view of all your downloads as they progress.

•	Fast 32 bit, multi-threaded downloading.

•	Very configurable:

•	Set different sounds for many events in GetRight.

•	Set directories for saving files by the type of file.

•	Set a list of usernames and passwords for logging into servers that need them.

•	Send each file to the virus scanner of your choice when it has finished.

•	Several types of log files to keep track of what you've done.

•	Setup when you want to start downloading new files (now, later, or prompt you).

•	Configure many options to behave the way YOU want.

•	Easy to use to start downloads:

•	Integrates into both Netscape Navigator/Communicator and Microsoft Internet Explorer (4.0) so using GetRight is seamless with your web browser.

•	Monitors the clipboard for addresses (URLs) to start downloading--easily start downloads from any program by just copying text.

 •	Drag-and-drop links from your web browser to GetRight.

•	GetRight can process a web page to find all the files available to allow you to quickly mark the ones you want to download.

•	Save and restore a list of files to download so you can re-download the same files again!


Basic Mode
Basic/Full Mode

Basic mode hides many of the advanced options to make it simpler for users who just want to download files without all the fancy extras.

Full mode provides access to all available functions in GetRight.

You may change between Full mode and Basic mode from either the Configuration window (General tab) or the Configuration Wizard.

Changes in Basic mode:

•	The Configuration Wizard is used instead of the many-tabbed Configuration window.

•	Many of the menu items and toolbar items are hidden on the Download Status and other windows.

•	The Download Status uses a different default toolbar (with text in the buttons.)

•	GetRight always operates in a sort of "Automatic" mode--as long as no errors occur, when a file finishes downloading, if there are more to be downloaded, then they are started.  But errors will stop this.

•	Most of the items you can setup on the many-tabbed Configuration window will still be used, even though you can't get back to that configuration window without switching back to Full mode.


Configuration Wizard

The Configuration Wizard is available in both Basic and Full modes.  (In Basic mode, it is used for all Configuration menu items.  In Full mode, a "Configuration Wizard" menu item is on the Download Status window, Edit menu.)

This Wizard is to make it easier for you to setup some of the most common and important options in GetRight.  Each of the "pages" contains some help text and a few simple choices.

What main Configuration items each page is helping you setup (these can help give a little more information about some of these items)

Registration:

Please register and pay for shareware.  (This one will not show if you have registered.)

GetRight Mode:

General tab, the "Basic ..." checkbox.

Internet Connection Type:

Sets up many of the different timeouts on the Connections tab  and File Mirrors tab and the number of files to do at once on the Limits tab.

Web Browsers:

Monitor tab.  the top items.

Prompting to Download:

Advanced tab, the "Start downloading immediately..." and "Prompt to start downloading..." items.

Geographic Location:

File Mirrors tab.  the top box

Proxy Servers:

Proxy tab.  (This one will not show if GetRight does not think you need proxy servers.)

Download When Connected:

Internet tab, the "Always start automatic downloading..." item.

Sounds:

General tab, sets up many of the sounds.

The "Some Sounds" item just sets sounds for finishing a download and prompting to hangup your modem or shutdown your computer.  The "All Sounds" sets many more sounds.

Logging Downloads:

Advanced tab, the "Write individual *.log file..." and "Keep log of all..." items.

Virus Scanner:

Advanced tab, the "Send to virus scanner..." item.

See the Full Configuration help for information about many of the other items you can configure in GetRight.


Requirements
Requirements to run GetRight

GetRight 3.0+ requires either Windows95 or WindowsNT 3.51 or greater.

•	If you have Windows 3.x, visit http://www.getright.com/install31.html for a version of GetRight that will work under Windows 3.x.

•	For most operating systems, visit http://www.getright.com/getright4j.html for information about using GetRight for Java.

GetRight requires an Internet connection in order to download from the Internet.


GetRight Download Window

See also:

•	Contents.

•	Configuring.

•	Resuming Downloads.


Things to try
Things to try if GetRight doesn't work

Bugs/Features

There are several known bugs/incompatibilities/features in GetRight.

•	GetRight does not consistently work with Trumpet winsock.  If you have problems, you can try using a different network connection program.  The "Windows Dial-Up Networking" that comes with Windows95 has worked fine.

•	Using the "Drag-and-Drop" method of starting downloads does not always work right if the link you are dragging is an image.  Many web browsers are dragging the picture instead of the link the picture represents.  To workaround this, use the clipboard method of starting downloads.

Proxy Servers

The other most common error is caused by the Proxy server settings not being correct.

Some Proxy servers (especially older ones) will not allow GetRight to resume downloads, no matter how much you fiddle with GetRight's Proxy settings.  If this is the case, ask your network administrator about upgrading their Proxy server software.

•	Try using both HTTP and FTP and see if just one doesn't work or if both don't work.

•	Verify your proxy server settings are of the format server.name:port  for example proxy.headlightsw.com:8080

•	 If GetRight works with HTTP, but not FTP; there are several things to try using the GetRight Proxy Configuration:

•	Try setting the Use HTTP protocol with FTP Proxy server option first.  (This one hopefully will do it.  This is the method used by Netscape's and Microsoft's web browsers.)

•	Try changing the FTP Proxy Type.

NOTE:  the CONNECT Address type is for use with a HTTP proxy server to hopefully get past a proxy server that does not allow resuming downloads.

•	If that doesn't make it work, then try setting the Use HTTP Proxy for FTP addresses.

•	As a last resort, try turning off both the above items and use the Use alternate (PASV) FTP download method.

•	If neither HTTP or FTP addresses work, try removing the entries for proxy servers (or uncheck the Use proxy servers option)

•	If the total file size changes after resuming a download, make sure that "Tell HTTP Proxy server to not use cache" is checked.

•	If the proxy server entries were already blank or Use proxy servers was already unchecked, ask your network administrator if you need a proxy server.

•	If you are getting an error about "Cache error," try making sure the "Tell HTTP Proxy server to not use cache" is checked.  If this still causes errors then you may not be able to use the settings for "CONNECT Address" for FTP or the "Use alternate connect" for HTTP.


For Advanced Users
For Advanced Users:

GetRight accepts several extra command line parameters:

   GETRIGHT filename.lst

Will have GetRight process a file containing a list of URLs to be downloaded (one URL per line.)  These URLs will be added to the list to be downloaded.

  GETRIGHT /AUTO [/HUP] [/OFF]

Will start GetRight to immediately enter automatic downloading mode.

The /HUP optional parameter will have GetRight hang up the modem when it has finished downloading.

The /OFF optional parameter will have GetRight shutdown the computer when it has finished downloading.

  GETRIGHT http://...

  GETRIGHT ftp://...

Will have GetRight get the specified URL.

GetRight will also accept the number of a current request to resume, but you'll have to look in the registry to find the request numbers, but if you do you can enter

  GETRIGHT #xx

where xx is the number from the registry to resume a single download.


Schedule Hang Up

GetRight has several options about scheduling GetRight to stop downloading and hang up your modem.  Any downloads in progress will be stopped when GetRight hang's up.

This would be useful if your phone rate changes at some time in the morning and you want GetRight to stop downloading before the rate increases.  For example, when combined with the scheduled dialing, you could set GetRight to start downloading at 1:00 AM and then stop at 7:00 AM.

NOTE:  This option is available if you are using either Windows Dial-Up Networking, or Other Networking Software (see Configuring-Internet)

NOTE2:  GetRight does not actually have to be downloading anything for it to hang up your phone at a specific time.

NOTE3:  If the "Turn Off Computer When Done" toolbar button is pressed on the Download Status, then at the scheduled time, GetRight will both hang up the modem and turn off the computer.

•	Hang up at a specific time:  A set of boxes will let you select a time to hang up your modem.  You may also setup to always hang up your modem at this time.

•	Hang up by a number of minutes after GetRight dials modem:  You can schedule GetRight to hang up your modem some time after it has dialed.  You may also setup so GetRight will redial and continue downloading after it has hung up, and so GetRight will always hang up this amount of time after dialing (it will hangup if you use the regular GetRight Dialer instead of scheduled dialing too.)

Example:  A good use for this, unlike in the US, many places in the world pay for all phone calls--even local calls.  I've been told that the British Telephone System now gives the first 19 minutes of a local call free--so you could schedule GetRight to hang up after 17 minutes of downloading and then dial again and continue to avoid charges.

{I don't know how well the phone company would like people doing this, but it's possible to do now.}

TIP:  Give less than the max to take into accout the time needed to make the connection and for GetRight's prompting to verify hanging up.

NOTE:  This option works only if GetRight is doing your Internet dialing!

•	Hang up by a number of minutes from Now:  Pretty self explanatory.  GetRight will hang up in the number of minutes from the time you click the OK button.

 •	Delay hanging up if any files being downloaded can not be resumed later:  Some servers do not support the resuming features in GetRight--with these, if GetRight hangs up, it will have to restart at the beginning.  This delays hanging up until any files in progress that can't be resumed are done.


Schedule Downloads
Schedule Download Start

[Available from the Download Status window, under the "Downloads" menu. ]

•	Do not do scheduled downloads:  Cancel scheduled downloads if you have enabled them.

•	"Today" only:  Download at the scheduled time "today."  Today is defined as the next 24 hours--so if it is 8 in the evening (PM), and you say to download at 2 in the morning (AM), then GetRight will start downloading at 2AM the next day--6 hours from the time you scheduled.

•	Download at this time on selected days:  This is for a re-occurring scheduled download.  Pick the days of the week when GetRight should download.  When the computer is turned on, GetRight will start downloading at the set time on the set days.  (And will turn on the options as setup below when the scheduled time arrives.)

The following checkboxes correspond to buttons on the Download Status window.

If these items are checked, they will press the buttons on the Download Status window both when this form is exited, and when GetRight starts a scheduled download on a day because the Download at this time on selected days option is enabled.  This is so you can setup GetRight to download on specific days and always redial, hangup, or shutdown your computer when it is scheduled on those days.

•	Redial modem if disconnected:  With this option enabled, GetRight will automatically redial and resume downloading without you having to do anything.  GetRight will use the options setup on the Internet configuration tab for redialing.

NOTE:  This option is only available if you are using Windows Dial-Up Networking (see Configuring-Internet)

•	Hang up modem when done:  After starting to download at the set time, GetRight will hang up your modem when ALL files have finished.

NOTE:  This option is available if you are using either Windows Dial-Up Networking, or Other Networking Software (see Configuring-Internet)

•	Turn off computer when done:  When all the files have been downloaded GetRight will turn off your computer.

NOTE1:  If your computer does not support automatic shutdowns, then this will exit Windows.

NOTE2:  If you turn this on, it is a good idea to close any other programs that are running.  This is so the computer doesn't sit waiting for you to answer prompts about "Save changes to XXX?" in other programs.


Advanced Link Drop
Tray Icon Menu Contents

The GetRight Monitor tray icon (or window) has several options for advanced users.  (see Accessing GetRight Monitor Menu for information about getting the menu of these choices.)

These menu options are available by Right clicking on the GetRight [image] tray icon, or by Right clicking in the window if the GetRight monitor is not running as a tray icon.

Double-clicking the [image] tray icon will show the Download Status window.

•	Clipboard and Click Monitoring:  This allows you to quickly enable or disable all monitoring of the clipboard or your web browser.  You will not need to restart your web browser for this to take effect.

•	Small Window:  (Not shown when tray icon)  This controls whether the window is larger and contains some instruction text, or if it is smaller and just contains the GetRight icon.  This option may also be toggled by double clicking in the body of the window with the left mouse button.  (Selecting this option while the GetRight program is minimized to an icon with Windows 3.x or Windows NT 3.x will cause odd results.)

•	Always On Top:  (Not shown when tray icon)  This controls whether the window remains on top of all other windows.  This would be used if you maximize your browser window and want to be able to still drag-and-drop to the GetRight window.  This option may also be toggled by double clicking in the body of the window with the right mouse button.

•	Show Monitor:  This option will show the GetRight monitor as a window instead of a tray icon.  This window is mostly used if you are using drag-and-drop to transfer files to download from your web browser.

•	Show Download Status:  This menu option brings up the dialog box so you may restart or delete selected downloads.  (See Download Status)

•	Downloads->Pause All:  Stop all downloads that are in progress.

•	Downloads->Automatic Downloading:  Set GetRight into "Automatic" mode.  It will start up up to the number of files you have set for "Downloading XX files at the same time" and obey all the other server limits on the Limits configuration tab.   When one download has completed, another will be started so it is back to your setting for "Downloading XX files at the same time".  It starts by downloading your Very High priority files first, then the High priority, etc.  More Info

•	Downloads->Schedule Downloads:  GetRight can be made to wait and start "Automatic" mode at a later time.  When the toggle menu is selected, then GetRight is in Scheduled mode.  More Info

•	Downloads->Turn Off Computer When Done:  This toggle menu shows whether GetRight will turn off your computer when it has finished downloading.  More Info

•	Downloads->Hang Up When Done:  This toggle menu shows whether GetRight will disconnect you from the Internet when files have finished downloading.  More Info

•	Downloads->Re-Dial if Disconnected:  This toggle menu shows whether GetRight will try to redial and resume downloading if it is interrupted by the network connection being lost.  More Info

•	Tools->Enter New URL:  This menu option brings up a dialog box so you may type in the address of a file to be downloaded.  You must enter the complete URL for the file.  For example:  http://www.headlightsw.com/index.html

•	Tools->Configuration:  This menu option brings up the GetRight configuration screen.

•	Tools->GetRight Dialer:  This menu option brings up the GetRight Dialer screen.  This is available to quickly use GetRight's Windows Dial-Up Networking dialer--one major advantage of using this is that it will redial if the line is busy.

When the GetRight Monitor is a window instead of a tray icon, clicking and dragging anywhere in the little window will move this window as if you had clicked in the titlebar.


Accessing GetRight Menu
Accessing GetRight Monitor Menu Items

NOTE:  The "GetRight Monitor" program must be running for these to be available.

For Windows 95 style user interface only:  If GetRight is normally minimized to the task bar, click with the right mouse button on the GetRight logo in the Windows tray icons in the Start bar to get the menu of options:

For either Windows 95 or Windows 3.1 style user interfaces:  In the "GetRight Monitor" window, left click the system menu in the upper left or right click on the window itself to get the menu of options.

For Windows 3.x style user interface only:  If GetRight is minimized, click on the icon to get the menu of options:

Click here for information about the different menu items in the menu that appears.


Starting Downloads Manually
Entering file addresses.

•	 Select "Enter New URL" in the GetRight Monitor menu (see Accessing GetRight Monitor Menu) or from the File menu on the GetRight Download Status window.

•	Type in the address or press Ctrl-V to paste the URL text you copied the text into the clipboard.  (If the clipboard text begins with http:// or ftp:// it is automatically pasted for you.)

•	Click OK.

•	GetRight will prompt you where to save the file.

•	GetRight will then get the file.  The download window should look similar to the window used in your web browser when downloading.

NOTE:  While this window is shown, GetRight will ignore any URLs copied to the clipboard (to make it easier for you to copy something that you want to edit.)


Starting Downloads
Starting File Downloads with GetRight.

Other Helpful Items:

•	Getting Started with GetRight

•	How Do I and Frequently Asked Questions

•	GetRight Help Contents

•	Tray Icon Menu Help

Starting Downloads with GetRight:

1)  Monitoring clicks in your web browser.

This method is by far the easiest.  It works with any version of Netscape Navigator or Communicator, or Microsoft Internet Explorer 4.0 or higher.

Opera Web Browser Users, please see:  http://www.getright.com/opera.html  for similar web browser monitoring!

GetRight will be triggered by these web browsers to automatically download some file types.  Just use your web browser as usual--GetRight will work when it needs to.

•	Make sure the "GetRight Monitor" program is running.  (More Information)

•	Use your web browser as usual.  When you encounter one of the common download types (.EXE, .ZIP, etc.) GetRight will automatically be triggered to download the file.  (This can be configured using the Monitor tab on the Configuration forms.)

Tips that work with either Netscape or Microsoft web browsers:

•	If you hold the SHIFT key when clicking a link, GetRight will not catch any link that is clicked.   This is useful for some web page forms or search engines that look like .EXE files to GetRight.

•	If you hold both the CTRL and ALT keys when clicking, GetRight will get any link that is clicked.

2)  Clipboard

(Any web browser, or any other program.)

GetRight monitors the contents of the clipboard to see if a web address (URL) is copied into the clipboard.

When a web address (URL) is copied to the clipboard, it automatically triggers GetRight to startup and get the file.

Copying the web address (URL) text to the clipboard:

•	Find a file you wish to get in your web browser.

•	Using Netscape's browser:  Click the Right mouse button on a file you wish to download, then pick the "Copy link location" item in the menu.

•	Using Microsoft's browser (Windows95/NT):    Click the Right mouse button on a file you wish to download, then pick the "Copy shortcut" item in the menu.

•	Using Microsoft's browser (Windows3.1):    Click the Right mouse button on a file you wish to download, pick "Properties" from the menu, then select the text in the URL box in the window that appears and press Ctrl-C to copy it to the clipboard.

•	Or from ANY other program--email, word processor, a different web browser, or anything else where you may see a web address (URL)--select the link text (looks like http://xxx.xxx.xxx/file.name or ftp://xxx.xxx.xxx/file.name) and press Ctrl-C to copy the text to the clipboard.

•	For the common download types (such as .EXE .ZIP, etc.), GetRight will automatically start as soon as the text is copied.

•	For most other types, GetRight will ask you whether it should download the file or not.

•	GetRight will prompt you where to save the file.

•	GetRight will then get the file.  The download window should look similar to the window used in your web browser when downloading.

•	NOTE:  If GetRight does not start to download, it may be set to skip that type of file in the clipboard (such as .HTM, .TXT, .GIF, etc.)  You may still easily start the download manually.

You may configure what GetRight does with different types using the Clipboard Configuration options.

3)  Drag-and-Drop

(Most web browsers.)

From your web browser that supports drag and drop (the current versions of both Microsoft Internet Explorer and Netscape Navigator do support drag and drop.)  Most Windows 3.x browsers do not support this.

•	Make sure the "GetRight Monitor" program is running and the window is visible.  (More Information)

•	Find a file you wish to get in your web browser.

•	Instead of clicking on the link (the highlighted, often blue underlined text), click the mouse button but don't release the button.  Still holding down the button, move your mouse cursor over the "GetRight Monitor" window.  And finally release the mouse button.  (More Information)

•	GetRight will prompt you where to save the file.

•	GetRight will then get the file.  The download window should look similar to the window used in your web browser when downloading.

NOTE:  You may not drag-and-drop to the GetRight icon when it is minimized to a tray icon in Windows95 or WindowsNT 4.  Double-clicking with the left mouse button on the GetRight logo icon when it is minimized to a tray icon will restore the GetRight Download Status window which can accept drag-and-drop items.  Clicking with the right mouse button when GetRight is minimized to a tray icon will bring up a menu of the Advanced Options.  Pick Show Monitor to show the small window for drag-and-dropping a URL.

4)  Typing in the URL:  (See here)

5)  For advanced users:

GetRight accepts the URL of the file to be downloaded as a command line parameter.

Entering the command:

GETRIGHT http://www.headlightsw.com/index.html

would start GetRight to download the specified file.


Forgot To Use GetRight
Forgot To Use GetRight...

So you forgot about GetRight and used some other program to download a file and it was disconnected.  There may still be hope for not having to start over at the beginning.

•	Make a copy of the file that was being downloaded before clicking OK on any messages from the other program that was downloading!  Otherwise the other program may clean up and delete the partial file.  (If the file has already been deleted, you may still be able to un-delete it using an UnDelete program or possibly the Recycle Bin in Windows95.)  Microsoft web browsers may store partially downloaded files in a hidden directory called MSDOWNLD.TMP.  You may need to turn on display of hidden files in Windows Explorer->Options.

•	Just in case, make a Second backup.  In a later step, if the server you select to resume the download does not support resuming, GetRight will start at the beginning--which will also lose the data in the file.

•	As an alternative, you may use GetRight to start downloading the file (to a different filename) from the server you intend to use to recover the original download.  After the download has started, press "Pause" then "Resume" to see if that server really will support resuming before using it to recover the partial file.  You may then Cancel the new test download.

•	Open the GetRight "Resume Download" window.

•	Either by using the "GetRight - Resume Dialog" item in the Start Menu or Program Manager's GetRight item.

•	Or by selecting the "Resume Downloads..." menu item from the GetRight monitor menu.  (see Accessing GetRight Monitor Menu for help getting this menu.)

•	Pick the "Recover Lost Downloads" item under the "Advanced" menu item.

•	Pick the copy of the file you made in the first step.

•	Enter the URL of the file you were downloading (normally looks like http://www.xyz.com/file.name  )


T_222054060060
Wildcards

GetRight can accept wildcards (* or ?) within filenames in FTP addresses.  Wildcards are allowed only in the filename or at the end of the path, not in the middle of the path.

ftp://ftp.xyz.com/pub/pc/*.exe

OK.  This would add all the EXE files in the directory to GetRight's download list.

ftp://ftp.xyz.com/pub/pc/*

OK.  For most FTP servers, using a single * will get all files in all subdirectories (so in the example, all files in /pub/pc and any subdirectories under /pub/pc).

ftp://ftp.xyz.com/pub/users/*/index.txt

No.  This would not work--the * must be in the filename, not the path.

http://www.xyz.com/*.html

No.  This would not work--wildcards are not accepted by HTTP servers (at least none that I have tried).  For similar functionality for HTTP servers, see the Web Page Processor.

GetRight will show the same window as used by the Web Page Processor so you may select where files should be saved, and view/edit the list of files GetRight found to be downloaded.

NOTE:  If you have not yet registered, you may see a "preview" of this function that does not have an OK button to add the files to your download list.


Hints and Tips
Hints, Tips, Notes, and Advanced features.

(Documenting the undocumented features...)

Some registry entries for items you can't setup from the interface.

Developers:  GetRight 3.3.3 and higher provide a simple DDE server so you can get information from GetRight about the downloads in progress--the most obvious use is for some screen savers that show the status of downloads from GetRight!  For more details and up-to-date examples, see:

http://www.getright.com/getright_dde.html

Sorting on the Download Status.  If you hold the CTRL key down when clicking on the header to sort by the file name column, GetRight will sort all the currently in progress downloads to the top.  If you hold the ALT key down when clicking on the header to sort by the file name column, GetRight will sort by the Priority of the downloads.

If you download a web page (HTML), when the file finishes downloading, GetRight will ask you if it should process the web page.  Processing the page will give you a list of all the links available from the page so that you may mark the items you wish to download.  More Info...

GetRight will automatically "fix" some file names for common file types there is no file extension/type in the file name.  For example, if you saved a file as just SETUP and GetRight detects that it really is a executable program, then GetRight will add .EXE to the name to be SETUP.EXE so it will run properly under Windows.  GetRight will do this for either .EXE or .ZIP files.  If there is any file extension used, then GetRight will not do this fix.

GetRight can download from sites that require a username/password in order to login.

You can setup usernames and passwords for servers you use often on the Login Configuration tab.

GetRight will also accept URLs with the format:

ftp://username:password@ftp.xyz.com/...

Or make sure the "Assume server login or timeout error means server is busy." option on the Connections Configuration tab is unchecked so and then GetRight will prompt you for a username/password.

If you hold the SHIFT key down while copying a URL to the clipboard or when monitoring clicks in your web browser, GetRight will ignore it.

If you hold both the CTRL and ALT keys when clicking on a link in your web browser, and GetRight is monitoring clicks in your web browser, GetRight will get the file no matter what type.

If you hold the ALT key down while copying a URL to the clipboard, GetRight will get it even if it is normally an "ignored" type (such as an .HTML file that is normally sent to your web browser.)

NOTE:  The key combination Ctrl-Alt-C does NOT copy text to the clipboard, however the key combination Ctrl-Alt-Insert does.

GetRight can accept wildcards (* or ?) within filenames in FTP addresses.  Wildcards are allowed only in the filename or at the end of the path, not in the middle of the path.

ftp://ftp.xyz.com/pub/pc/*.exe

OK.  This would add all the EXE files in the directory to GetRight's download list.

ftp://ftp.xyz.com/pub/pc/*

OK.  For most FTP servers, using a single * will get all files in all subdirectories (so in the example, all files in /pub/pc and any subdirectories under /pub/pc).

ftp://ftp.xyz.com/pub/users/*/index.txt

No.  This would not work--the * must be in the filename, not the path.

http://www.xyz.com/*.html

No.  This would not work--wildcards are not accepted by HTTP servers (at least none that I have tried).  For similar functionality for HTTP servers, see the Web Page Processor.

GetRight will show the same window as used by the Web Page Processor so you may select where files should be saved, and view/edit the list of files GetRight found to be downloaded.

NOTE:  If you have not yet registered, you may see a "preview" of this function that does not have an OK button to add the files to your download list.

GetRight should detect if a server really will support resuming before it needs to resume.   But if you want to test if a server really will resume before getting too far into a large file, wait until the file has been downloading for a few seconds, then click Pause, then Resume.  This will check to see if the file really can be resumed.

If you type in a filename in the "Save As" window that does not contain any file extension (such as ".EXE"), then GetRight will automatically add the previous file extension.  So if you change "file.zip" to "XYZDemoInstaller", GetRight will automatically add ".zip" back onto the name to get "XYZDemoInstaller.zip".  If the filename contains any periods, then GetRight will not do this (but should prompt you about changing the file type.)

When a new file is downloaded by GetRight, the suffix .GetRight will be added to the filename on the disk to indicate that the file is not complete.  When the file finishes downloading, then it will automatically be renamed to remove the .GetRight.  From a user perspective looking at GetRight, this is invisible--it removes the .GetRight for prompts and for displaying.  But it will be visible if you look at the files in the directory while they are being downloaded.

Files from ZDNet and a few other sites that use a CGI-redirecting method will not be named until after GetRight has determined the redirected location.  Until the correct name can be determined, the placeholder of RENAME.ME will be used.  (Any file that has the file name within the URL of GETIT.BIN or DOWNLOAD.PL will be treated in this way.)

GetRight's Setup program will ask you to setup to handle Download.Com's Download Manager files.  You may add or remove this setup later by entering either of the following commands:

GETRIGHT.EXE /VSL

Setup to handle Download.Com's Download Manager files.

GETRIGHT.EXE /NOVSL

 	Setup to not handle Download.Com's Download Manager files.

This updates the registry and only needs to be run once--not each time GetRight is executed.

Enter GETRIGHT.EXE /? to see all the command line options that GetRight will accept

The SAMPLE*.BAT files in the GetRight directory also demonstrate using some of the command line options to script downloads with GetRight.

If you have alternate addresses for a file, they may be discarded by GetRight for several reasons:

•	If you are resuming a download, a server that does not support resuming will be discarded.

•	If the size of the file is different than the size from the first server, GetRight assumes that they are different in some way and using it would very likely corrupt the file.

When running under Windows 3.1, GetRight will automatically shorten filenames to be use 8.3 filenames.

If you forgot to use GetRight and started downloading with another program and it was disconnected, there may still be hope for you!

With a lots of effort, it is possible to use GetRight to download files for Microsoft's programs that use Active Setup.

This is should be attempted by Expert users Only.  Information is at:

http://www.getright.com/active.html

Advanced Options (Registry Settings):

The easiest way is to get the GetRight More Configuration which is a small program that allows you to easily set these items.  It is located in the same directory where GetRight is installed on your computer.

You may also add/delete the registry settings by hand.  Doing any editing in the registry can be a risk if you aren't careful, or don't know what you are doing.  This assumes you know what you're doing--if you don't know how how to safely edit the registry, don't do these--get the MicroManager tool to do it safely!

•	Tray Icon:  Not everyone loves the built-in GetRight tray icons [image].   But GetRight now allows you to use any icon (.ICO) file as the GetRight Monitor tray icons.

You may set one icon for the "regular" appearance, and one for the "scheduled" appearance.  If no scheduled icon is specified, the regular one will be used.

You can also set the icon to be used in the small drag-drop window too.

[HKEY_CURRENT_USER\Software\HeadLight\GetRight\Config]

TrayIconNormal = "c:\file.ico"	(String)  [use right path to .ico file]

TrayIconClock = "c:\file.ico"	(String)  [use right path to .ico file]

DropIconNormal = "c:\file.ico"	(String)  [use right path to .ico file]

•	User-Agents:  To make GetRight send something different as the "User-Agent" in a HTTP request:

[HKEY_CURRENT_USER\Software\HeadLight\GetRight\Config]

UserAgent = "*"	(String)

 	Where * is any value you wish.  Some browser values include:

Netscape:  	Mozilla/4.06 [en] (Win98; I)

Microsoft:	Mozilla/4.0 (compatible; MSIE 4.01; Windows 98)

Opera:	Mozilla/3.0 (compatible; Opera/3.0; Windows 95/NT4) 3.21

(Some sites have "blocked" GetRight for various reasons--like the features to find the fastest server does ping their server periodically--or because it can keep trying to connect if the server is busy.  Changing this may let you get back in--until they block your IP address completely, so beware.)

•	Referer (sic):  GetRight (like your web browser) sends a "referer" header to tell the server where you clicked on a link to the file.  GetRight does calculate a value from your web browser for this, but it can easily be the wrong one if you have several browser windows open.

To not send any calculated referer information the registry setting is:

[HKEY_CURRENT_USER\Software\HeadLight\GetRight\Config]

Referer = 0	(DWORD)

GetRight can also send a generated value.  The value is generated as:  http://server/index.html where server is the server name from the URL with the file.  This will help with some servers that do checks that you clicked on the link to the URL from their web site--and GetRight is getting the referer from the wrong browser window.

[HKEY_CURRENT_USER\Software\HeadLight\GetRight\Config]

GenerateReferer = 1	(DWORD)

•	Do Web Page Processor:  You can have GetRight never start it's web page processor when it downloads a web page:

[HKEY_CURRENT_USER\Software\HeadLight\GetRight\Config]

DoWPP = 0	(DWORD)

•	No Splashes:  To make the "Splash" windows not appear when starting GetRight or opening some windows:

Note: with GetRight 3.3 and higher, this may not work for all spash screens...

[HKEY_CURRENT_USER\Software\HeadLight\GetRight\Config]

DoSplash = 0	(DWORD)

•	Hangup/Shutdown Timer:  When using the "Hangup When Done" or "Turn Off Computer When Done" items, GetRight uses a default 30 second timer to let someone cancel in case the computer is in use.  You may change the time by editing these registry settings.  The value is in seconds.

[HKEY_CURRENT_USER\Software\HeadLight\GetRight\Config]

TurnOffTimer = 30	(DWORD)

HangupTimer = 30	(DWORD)

•	More Silly Animations:  To make the icon on the GetRight Monitor spin like on the individual download windows, add:

(You must restart GetRight after making this change.)

[HKEY_CURRENT_USER\Software\HeadLight\GetRight\Config]

AnimateMonitor = 1	(DWORD)

•	Tray Icon Double-Click Action:  By default, GetRight opens the Download Status when you double click the GetRight logo tray icon.  To make it instead open the GetRight Monitor window, add:

[HKEY_CURRENT_USER\Software\HeadLight\GetRight\Config]

TrayOpenMonitor = 1	(DWORD)

•	Download Thread Priority:  In a little testing, this didn't make any difference on my computer (the modem was always the slow point).  But I don't know what effect this might have on download speeds, or performance of GetRight and other programs on other computers.  This might help if you're doing something very complex--like playing games--while downloading.

To change the priority of the download windows (threads) that GetRight uses for downloading:

 	[HKEY_CURRENT_USER\Software\HeadLight\GetRight\Config]

ThreadPriority = #	(DWORD)

 Where # is 1, 2, or 3.  2 is the normal priority (default value).  1 is higher than normal priority, 3 is lower than normal priority.

•	Debugging the GetRight Click Monitoring:  For a few people, the GetRight click monitoring has stopped working.  To help figure out why, you can turn Debugging for the GetRight click monitoring.  A GetRightClick.log file in the directory where GetRight is installed will be used to store information about the GetRight click monitoring.

[HKEY_CURRENT_USER\Software\HeadLight\GetRight\Config]

DebugClicks = 1	(DWORD)

(You must restart your web browser after changing this value.)

•	Tray Icon Tools Menu:  You may change so the items in the GetRight tray icon Tools submenu are not in a submenu and are in the initial tray icon menu.

[HKEY_CURRENT_USER\Software\HeadLight\GetRight\Config]

ToolsSubmenu = 0	(DWORD)

Protocols Supported by GetRight.

Errors:

While GetRight tries to handle this error, it may still occur:  If you get an error about "Save As" cancelled when you didn't even see the Save As window, it is probably caused by having the default directory deleted (or pointing to a directory that does not exist.)  On the Save To configuration form, make sure that all the directories still exist, and set to not use the last directory if that option is selected.


Starting Link Drop Window
Starting GetRight

(If you allowed it, the setup program added this to your startup group so that it will automatically start when you start Windows.)

Windows 95 style user interface.

•	From the Start menu, then Programs, then GetRight, then "GetRight Monitor"

Windows 3.x style user interface.

•	From the Program Manager, in the GetRight group, run "GetRight Monitor".


Drag and Drop

•	Click on the link, but don't release your mouse button.

•	"Drag" - move your mouse with the button still held down - until the mouse cursor is over the "GetRight Monitor" window.  (The mouse cursor will look different when it is over a program where you can drop the information.)

•	"Drop" - release your mouse button while it is still over the window.


FileMirrorLists
File Mirror List (.FML)

GetRight supports "File Mirror List" .FML format files.  These are special files that contain a list of many different URLs from which a file may be downloaded.

This allows GetRight to build a list of possible locations for the real file you want to downloaded.  GetRight will then transparently change between these different alternate URLs if servers are busy or if other problems occur.  Normally these "File Mirror Lists" would be downloaded from the server where you found the file you wished to download, so using this is as simple as clicking on a link.  (See also Configuration - File Mirrors).

GetRight also supports Download.Com's "Download Manager" format files (.VSL) which do exactly the same thing.

Finding File Mirror Lists.

One software site that has file mirror lists available for ALL their downloads is FileMine.  www.filemine.com

MAKE_FML Utility:

To speed up the adoption of this file format, the utility MAKE_FML.EXE has been included with GetRight in order to build these files from a web page that lists a set of locations from which a file can be downloaded.

The MAKE_FML.EXE utility is FREE and may be freely distributed.

Contact HeadLight Software if you are making your own FML creation utility, or will support FML files from your site, or any other reason, and would like the source code for MAKE_FML.

Creating FML files:

Most software distribution sites already provide a list of address for you the user to pick which site to download a file from; it is very easy to build a FML file from one of these pages.

•	 When viewing the page containing a list of sites in your web browser, save it to your hard drive (Under the File menu someplace.)

•	Then run MAKE_FML and type in or Browse to enter the filenames for both the input and output files.

•	To get the desired results, especially with servers which give you a list which "redirects" through their own server, you may need to add more types in the bottom list of file extensions (or .*; to do all files) or use the checkbox to include every possible URL.

You may need to edit the file and remove any extra items that are not correct for these "redirect" type pages.

If you build a FML file with this utility (or using some other means), you can submit it to HeadLight Software for to be included on a site of File Mirror Lists.  (NOTE: HeadLight Software reserves the right to include or exclude any file submitted at its discretion.)

Visit the address below to determine how to submit an FML file, to see all the File Mirror List downloads available, or to get links to other sites which support File Mirror Lists:

http://www.headlightsw.com/fml/

A file format specification for .FML files may also be found at the above address.


Country Codes
Internet Country Codes

For most countries, your Internet Country Code is the last two characters of your email address.

If your email address ends in .COM, .NET, .ORG, .GOV, .EDU, .MIL, etc. you can lookup your code below (though these are usually United States addresses and your code is US.)

Click a letter below to jump to the spot in the list (sorted by Country).

   A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

A	top

AF  Afghanistan

AL  Albania

DZ  Algeria

AS  American Samoa

AD  Andorra

AO  Angola

AI  Anguilla

AQ  Antarctica

AG  Antigua and Barbuda

AR  Argentina

AM  Armenia

AW  Aruba

AU  Australia

AT  Austria

AZ  Azerbaijan

B	top

BS  Bahamas

BH  Bahrain

BD  Bangladesh

BB  Barbados

BY  Belarus

BE  Belgium

BZ  Belize

BJ  Benin

BM  Bermuda

BT  Bhutan

BO  Bolivia

BA  Bosnia and Herzegovina

BW  Botswana

BV  Bouvet Island

BR  Brazil

IO  British Indian Ocean Territory

BN  Brunei Darussalam

BG  Bulgaria

BF  Burkina Faso

BI  Burundi

C	top

KH  Cambodia

CM  Cameroon

CA  Canada

CV  Cape Verde

KY  Cayman Islands

CF  Central African Republic

TD  Chad

CL  Chile

CN  China

CX  Christmas Island

CC  Cocos (Keeling Islands)

CO  Colombia

KM  Comoros

CG  Congo

CK  Cook Islands

CR  Costa Rica

CI  Cote D'Ivoire (Ivory Coast)

HR  Croatia (Hrvatska)

CU  Cuba

CY  Cyprus

CZ  Czech Republic

D	top

DK  Denmark

DJ  Djibouti

DM  Dominica

DO  Dominican Republic

E	top

TP  East Timor

EC  Ecuador

EG  Egypt

SV  El Salvador

GQ  Equatorial Guinea

ER  Eritrea

EE  Estonia

ET  Ethiopia

F	top

FK  Falkland Islands (Malvinas)

FO  Faroe Islands

FJ  Fiji

FI  Finland

FR  France

FX  France, Metropolitan

GF  French Guiana

PF  French Polynesia

TF  French Southern Territories

G	top

GA  Gabon

GM  Gambia

GE  Georgia

DE  Germany

GH  Ghana

GI  Gibraltar

GR  Greece

GL  Greenland

GD  Grenada

GP  Guadeloupe

GU  Guam

GT  Guatemala

GN  Guinea

GW  Guinea-Bissau

GY  Guyana

H	top

HT  Haiti

HM  Heard and McDonald Islands

HN  Honduras

HK  Hong Kong

HU  Hungary

I	top

IS  Iceland

IN  India

ID  Indonesia

IR  Iran

IQ  Iraq

IE  Ireland

IL  Israel

IT  Italy

J	top

JM  Jamaica

JP  Japan

JO  Jordan

K	top

KZ  Kazakhstan

KE  Kenya

KI  Kiribati

KP  Korea (North) (People's Republic)

KR  Korea (South) (Republic)

KW  Kuwait

KG  Kyrgyzstan (Kyrgyz Republic)

L	top

LA  Laos

LV  Latvia

LB  Lebanon

LS  Lesotho

LR  Liberia

LY  Libya

LI  Liechtenstein

LT  Lithuania

LU  Luxembourg

M	top

MO  Macau

MK  Macedonia

MG  Madagascar

MW  Malawi

MY  Malaysia

MV  Maldives

ML  Mali

MT  Malta

MH  Marshall Islands

MQ  Martinique

MR  Mauritania

MU  Mauritius

YT  Mayotte

MX  Mexico

FM  Micronesia

MD  Moldova

MC  Monaco

MN  Mongolia

MS  Montserrat

MA  Morocco

MZ  Mozambique

MM  Myanmar

N	top

NA  Namibia

NR  Nauru

NP  Nepal

NL  Netherlands

AN  Netherlands Antilles

NT  Neutral Zone (Saudia Arabia/Iraq)

NC  New Caledonia

NZ  New Zealand

NI  Nicaragua

NE  Niger

NG  Nigeria

NU  Niue

NF  Norfolk Island

MP  Northern Mariana Islands

NO  Norway

O	top

OM  Oman

P	top

PK  Pakistan

PW  Palau

PA  Panama

PG  Papua New Guinea

PY  Paraguay

PE  Peru

PH  Philippines

PN  Pitcairn

PL  Poland

PT  Portugal

PR  Puerto Rico

Q	top

QA  Qatar

R	top

RE  Reunion

RO  Romania

RU  Russian Federation

RW  Rwanda

S	top

GS  S. Georgia and S. Sandwich Isls.

KN  Saint Kitts and Nevis

LC  Saint Lucia

VC  Saint Vincent and The Grenadines

WS  Samoa

SM  San Marino

ST  Sao Tome and Principe

SA  Saudi Arabia

SN  Senegal

SC  Seychelles

SL  Sierra Leone

SG  Singapore

SK  Slovakia (Slovak Republic)

SI  Slovenia

SB  Solomon Islands

SO  Somalia

ZA  South Africa

SU  Soviet Union (former)

ES  Spain

LK  Sri Lanka

SH  St. Helena

PM  St. Pierre and Miquelon

SD  Sudan

SR  Suriname

SJ  Svalbard and Jan Mayen Islands

SZ  Swaziland

SE  Sweden

CH  Switzerland

SY  Syria

T	top

TW  Taiwan

TJ  Tajikistan

TZ  Tanzania

TH  Thailand

TG  Togo

TK  Tokelau

TO  Tonga

TT  Trinidad and Tobago

TN  Tunisia

TR  Turkey

TM  Turkmenistan

TC  Turks and Caicos Islands

TV  Tuvalu

U	top

UG  Uganda

UA  Ukraine

AE  United Arab Emirates

UK  United Kingdom (Great Britain)

US  United States

UY  Uruguay

UM  US Minor Outlying Islands

UZ  Uzbekistan

V	top

VU  Vanuatu

VA  Vatican City

VE  Venezuela

VN  Viet Nam

VG  Virgin Islands (British)

VI  Virgin Islands (US)

 W	top

WF  Wallis and Futuna Islands

EH  Western Sahara

X	top

Y	top

YE  Yemen

YU  Yugoslavia

Z	top

ZR  Zaire

ZM  Zambia

ZW  Zimbabwe


Why GetRight?

GetRight has several big improvements over the standard download ability built into your web browser and other downloading tools.

  RESUMING:  GetRight can gracefully recover and resume from many errors that happen while downloading files.  With a web browser, if an error occurs while you are downloading a file, you must restart the entire download and get 100% of the file.  With GetRight, it is simple to resume the download and only get the remaining part of the file.

For example, (and the incentive to start writing this program), I was downloading a large file over a 28.8 modem.  After an hour or so it gotten about 95% downloaded when it was disconnected.  With the web browser I had to start over and get the entire file again--another hour or more of downloading.  So I wrote GetRight.  Using GetRight, I would only have to get the remaining 5% of the file--just a few minutes of downloading.  GetRight can now even redial your Internet Service Provider and resume downloading without you having to do anything.

GetRight has been tested and successfully recovered from:

•	Turning off the computer while downloading.

•	Unplugging the modem from the wall while downloading.

•	Someone picking up a telephone extension while downloading.

•	And lots more.

   LISTS: GetRight can be setup to build a list of downloads to be completed later.  GetRight can be scheduled to start downloading at a selected time.  GetRight can easily be made to dial your Internet Service Provider (ISP) when it is time to make the connection, download the files, then disconnect the modem or even turn off the computer when it has finished downloading the files.

   ALTERNATES:  GetRight supports several file formats for determining alternate addresses for downloading files.  GetRight supports its own "File Mirror Lists" .FML format files, Download.Com's "Download Manager" .VSL format files, and can even automatically calculate alternate addresses for common mirrored servers. This allows GetRight to build a list of possible locations for the real file you want downloaded.  GetRight will then find the fastest of these servers for downloading and transparently change between these different alternate URLs if servers are busy, if another server appears to be the fastest, or if other problems occur.

Normally these alternate address list files would be downloaded from the server where you found the file you wished to download, so using this is as simple as clicking on a link.  (See also Configuration - Country)

More information about File Mirror Lists...

   SCHEDULING: GetRight can be easily setup to download your files at a specific time, including dialing your modem at that time, and hanging up your modem when it is done (such as at night when phone rates are less).  You can also schedule GetRight to hang up your modem and stop downloading at a specific time (such as in the morning when phone rates increase)

   EASY TO USE: GetRight "catches" clicks within both Netscape Navigator/Communicator or Microsoft Internet Explorer.  Using GetRight to download is as easy as using your web browser.

   CONTROL: GetRight has many configuration options and features to suit users from the most novice user who just wants to download a file, to the most sophisticated power user who wants to control every feature to suit their exact needs.

   SPEED:  Many users see improved download speeds using GetRight instead of other download programs (such as your web browser.)  Quite a few users have seen speed improvements of 10% or more, but not everyone has seen this improvement so your experience may vary.  (Some things to check if GetRight downloads slower than other programs.)


Resuming Downloads
Resuming File Downloads.

There are several ways to resume downloading files:

1.	If the GetRight window for the file you wish to resume is still available in its download window, just switch to that window and press the "Resume" button.

2.	If the GetRight window is no longer running, start the "GetRight - Download Status".

You may start this by double clicking on the GetRight logo in the tray icons or from the "Show Download Status..." item in the GetRight Monitor menu   (see Accessing GetRight Monitor Menu for help getting this menu.)

The window is filled with a report view of all your in progress downloads.  You may use the menus and toolbars at the top of the form to resume or delete selected downloads.  (More Information)

You may also start this program by running it from the Start menu or Program Manager:

 	Windows 95 style user interface.

*     From the Start menu, then Programs, then GetRight, then "GetRight - Download Status"

 	Windows 3.x style user interface.

*     From the Program Manager, in the GetRight group, run "GetRight - Download Status".

For advanced users:

GetRight accepts the command to resume all requests as a command line parameter.

Entering the command:

GETRIGHT /AUTO

would start GetRight and start GetRight's Automatic Downloading mode.  You may add optional parameters to this command: /HUP will have GetRight hang up the phone when it is done, and /OFF will have GetRight shutdown the computer when it has completed.


Web Page Processor
GetRight Web Page Processor.

If GetRight downloads a web page it will ask you about processing the page to find all the links and let you pick which items GetRight should download.  (GetRight looks at the beginning of the file for an <HTML> tag--the file extension .HTM, .HTML, .??? doesn't matter at all.)

NOTE:  If you have not yet registered, you may see a "preview" of this function that does everything, except have an OK button to let you actually add the files to your download list.

This form contains two tabs  [Select Files]  [Save Options]

Select Files

This tab lets you select which files from this page should be downloaded.

The top portion of this tab shows a report of all the links available on the web page.  The columns are:

A checkbox on the left indicates if each item should be downloaded or not.

File:  The filename of the item as extracted from the full address (URL).

Type:  The file extension or type of the file, such as .GIF, .ZIP, etc.  This lets you easily group the files by type if you want to just download a specific type of file (such as all the images.)

<xxx >:  Indicates the type of HTML tag where the item was found.  For example, if you were using GetRight to download images from a page that contained small thumbnail versions of images which were links to the real full size images, you could tell which were which since the thumbnail views of images would show IMG here and the full size images would show A here.

#:  Number indicating the order of the items found on the web page.

Full Address (URL):  The complete URL of the item.

At the bottom of the tab is a list of common file categories so you may quickly mark all the files of a specific type (such as quickly mark all the image files--even if they are different "types" like .GIF or .JPEG.)

•	The Plus (+) button next to each of these categories will place a checkmark for all files of that category.

•	The Minus (-) button will remove checkmarks for all files of that category.

The current file extensions used for each category:

Files:

•	 .EXE  .BIN  .ZIP  .SIT  .HQX  .TAR  .TGZ  .ARJ  .LZH  .GZ  .Z  .FML  .VSL

Images:

•	 .GIF  .JPG  .JPEG  .JPE  .TIF  .BMP  .MP3  .MPG  .MPEG  .AVI  .MOV

Sounds:

•	 .WAV  .AU  .RA  .RAM  .AIF  .AIFF  .MID  .MIDI  .LAM

Pages:

•	 .HTM  .HTML  .ASP  .SHTML  .SHTM  .CHTML  .CHTM  .TXT  .TEXT

All:

•	 Everything in the report.

(User Entered):

•	 Type in any extension you want.  Wildcards (? and *) are OK:  .HTM* would select .HTM, .HTML, etc.

<Back To Top>

Save Options

This tab contains several other options you can setup about how and where these extracted links should be saved.

Directory For Files

•	Use Directory(s) setup on Configuration "Save To":  This option uses your default settings for where files should be saved.  Clicking the "Change" button will show the Configuration form so you could change these default settings.

•	Save to:  This lets you over-ride the default settings and save the files extracted to a specific directory.  All files will be stored in this directory (or under it--see the next item.)  Enter a valid directory, or use the "Browse" button to select the directory.  (If this directory does not exist, it will be created for you when you click "OK")

•	Recreate directory structure:  This checkbox is available if you have selected the "Save to" item above.  This will create a directory structure similar to that on the server.

For Example, if you are saving to the directory C:\GETRIGHT\ , the web page you are processing is http://www.getright.com/get.html , and this page contains the image http://www.getright.com/images/logo.gif ; then GetRight would create the directory C:\GETRIGHT\IMAGES\ and would store the image there.

NOTE:  This will only work for files that are located on the same server, and are in a subdirectory of the web page being processed.

Other Options

•	Use default name and do not prompt for file name:  This causes GetRight to skip prompting you for the filename, and automatically uses the default name (if a file with that name does not already exist in the directory.)  For example, if you were downloading http://www.headlightsw.com/faq.html, GetRight would automatically save the file with the name faq.html (or faq.htm if you are using Windows 3.1) into your default directory and would not prompt you at all.

•	Download all files later:  GetRight will not start these downloads now if this item is checked (and will not prompt about downloading them now or later.)  You will need to use the Download Status form to start these downloads later.

•	If file names are the same, add addresses as alternate download sites:  Pretty much what it says.  If the name of the file is the same, it will be added as an alternate (or added as a separate file to be downloaded).

•	Play "File Added" sound:  If you are importing many files, having GetRight play the "File Added" sound for each one can be very annoying.  This turns off playing the sound while these addresses are added.

<Back To Top>


Resume Connections
GetRight Download Status

The window shows a report of all files that GetRight is currently downloading.  You may select one or more items in the listbox (hold Ctrl or Shift when selecting to pick more than one item) to do any of the functions from the toolbar or menu.

NOTE:  In Basic mode, quite a few of these options will be hidden.  An asterisk (*) will be in the functions that will be hidden in Basic mode.  While the main menu item is hidden in Basic mode, some are still available from Right clicking on an item in the list.

Menu items:

[File] [Edit] [Downloads] [Advanced] [View] [Help]

Other items:

[Toolbar] [Spreadsheet/Report] [Graph]

File Menu

•	  Enter New URL:  Type in a URL to be downloaded.  Adds the new item to the spreadsheet.  (Shortcut key:  Ctrl+N)

•	Download Updated Mirror List:  If you start downloading from one of the most common mirrored sites, or any of their mirrors (such as SimTel.Net or TUCOWS) GetRight will automatically calculate a list of alternate addresses.  GetRight uses a MIRRORS.LST in the directory where it is installed to calculate these alternates.

Use this option to download an updated version of this file to get the latest set of mirrors.

This MIRRORS.LST file contains documentation on its structure so you may add other customized lists of mirrors.  If you create a mirror sets that would be useful for other people, please contact mjb@headlightsw.com so it may be added.

•	  Export List of Selected Downloads*:  Save a file of information about the selected downloads.  This file may be imported later to restore the downloads if you wish to re-download the files again later.

NOTE:  If you change where the partially downloaded files are located on your computer, you should edit the exported file so that GetRight knows the correct locations when this file is re-imported.

The format of this file is included as a header in all files you export.

•	  Import Download List*:  Bring in a list of files to be downloaded.

NOTE:  If you change where the partially downloaded files are located on your computer, you should edit the  file before importing it so that GetRight knows the new locations of any partially downloaded files.

•	Process Web Page File*:  This allows you to run GetRight's Web Page Processor on a web page (.HTM, .HTML, etc.) file that is located on your hard drive.

You will be prompted for the file to process, then the URL where the file was found.

NOTE:  If the file contains a <BASE > tag, then the URL is not really needed, but if the file does not contain a <BASE > tag and the URL is left blank, then any relative items will not be shown in the Web Page Processor.  (Relative items are like:  <A HREF="index.htm">home</A> that do not give a full URL to the file.)

•	Recent Finished Files:  This displays a menu of the last 4 files which GetRight has finished downloading.  Clicking any of the items will open/run that file.  (For example; if the file is a .EXE, then the program will be run; or if if the file is a .HTML file, your web browser will be opened to view the file.)

•	Recent Finished URLs:  This displays a menu of the last 4 URLs which GetRight has finished downloading.  Clicking any of the items will have GetRight add the URL back into its list of files to be downloaded.

•	Exit:  Close this window (hopefully you could figure that one out for yourself :)

(Top of page)

Edit Menu

•	Select All:  Selects all the rows in the spreadsheet.  (Shortcut key:  Ctrl+A)

•	Select All In Progress:  Selects all the rows in the spreadsheet for downloads that are currently in progress.

•	Delete Selected Download(s):  Deletes all the items currently selected in the spreadsheet.  (And deletes all the partially downloaded files.)  (Shortcut key:  DELETE)

•	Remove Selected Download(s):  Similar to Delete, except this will remove the selected downloads from GetRight's download list, but the partially downloaded files will be left on your computer.  This is useful after exporting a list of files that you wish to import and finish later--so the partial files are left around on your hard drive.

•	Toolbar*:  You can show/hide categories of buttons from the toolbar, or show/hide the entire toolbar.  This also lets you change the toolbar appearance from "Classic" (Windows95, raised buttons) to "New" (IE3+, Windows98, flat buttons).

•	Animated Chains*:  You can turn on or off the animated (spinning) chains that display when a file is downloading.  The chains will still change colors and some shapes to show status, but will not spin when a file is being downloaded.

•	Configuration Wizard*:  Runs the Configuration Wizard.  This makes it much simpler to setup some common options (but does not provide access to many of the advanced options.)

•	  Configuration:  In Basic mode, this will show the Configuration Wizard.  Setting up GetRight (see Configuring GetRight)

(Top of page)

Downloads Menu

•	  Resume:  In Basic mode, this will be labeled Download!.  Resume downloading all the selected items in the spreadsheet.

Each item that is in progress will be indicated with either an animating chain, or one of the following icons:

 = A download in your list (also may include arrows to indicate priority)

 = In progress connecting to the server.

 = OK and currently downloading (this one is animated).

 = An error occurred.

 = Server was busy, waiting to reconnect.

 = GetRight is searching for alternate addresses.

 = The download has been paused by you.

 = File is done downloading.

•	  Pause:  Stop/Pause downloading all the selected items in the spreadsheet.

•	   Open Source Web Page -->:  When GetRight is starts a new download, it calculates the current web page that is shown in your web browser.  This option allows you to resume to that page at a later time (in case you forgot exactly what an item is, or wish to start a different download from that page).    (Shortcut key:  Ctrl+O)

NOTE1:  The toolbar button shown for this will vary depending on your web browser, but will be one of those shown above.

NOTE2:  This option may not work properly for pages that are in Frames (can return to the parent frame), if you have several browser windows open, or if you start the download from some other source (such as an email program.)

•	  File Comment:  This allows you to add a short comment or description about the download.  The text you enter will be shown in place of the Address (URL) on this form, and on the individual download windows.  While you may enter a very long description, only about 50 characters will be visible in the individual download window.

You may edit an existing comment to change it.  If you change an existing comment to be "blank", then the Address (URL) of the file will be shown again.  (Shortcut key:  Ctrl+I)

•	   Pause All:  Stop/Pause downloading all the items in the spreadsheet.

•	  Automatic*:  Set GetRight into "Automatic" mode.  It will start up up to the number of files you have set for "Downloading XX files at the same time" and obey all the other server limits on the Limits configuration tab.   When one download has completed, another will be started so it is back to your setting for "Downloading XX files at the same time".  It starts by downloading your Very High priority files first, then the High priority, etc.  If you set it, when all files have been downloaded, GetRight will disconnect you from the Internet or shutdown your computer (or windows).

When the toolbar button is pressed and there is a check in the menu, then GetRight is in automatic mode.  Pressing the toolbar button or selecting the menu again will turn off Automatic mode (however any files in progress will continue to download.)  Also, if you cancel or pause any downloads in progress, Automatic downloading will be turned off as well.  (Shortcut key:  Ctrl+G)

Since Automatic mode is often used for unattended downloads where GetRight will get no user-response to any messages, when in Automatic mode, GetRight will not show error messages.  If there is an error, it will skip to the next file to download.  If the error is likely because of a refused login into a busy FTP server, GetRight will later go back and try again when all other downloads are done, or have errors.  (And when trying again later, it will use the timers and counters you have setup on the Connections tab.)

•	  Schedule Downloads*:  GetRight can be made to wait and start "Automatic" mode at a later time.  When the toolbar button is pressed and there is a check in the menu, then GetRight is in Scheduled mode.  (See Scheduling Downloads)

•	   Schedule Hang Up*:  GetRight can hang up your phone at a specific time and will stop any downloads it has in progress when it does this.  (See Schedule Hang Up)

•	   Download Windows As*:  This menu/button has a sub menu so you can pick how the individual download progress windows should be displayed.  Any current downloads will be changed to the display method you pick.  (Reselecting the item with the check will reset all windows to that state as well, in case you restored or minimized them.)

Normal Window = Show as a regular window.  (In Basic mode, all windows are shown as normal windows.)

Minimized Windows = Regular window, but it starts minimized in the taskbar.

Tray Icons = As a small icon in your tray icons in the taskbar.  Right clicking on the tray icon will show a menu to allow you to restore the larger window, pause/resume the download, or close the download.  Double-clicking on the tray icon will restore the larger window.

Hidden = Windows are not visible.  You can view the Download Status window.  Note that if the Download Status window is not open then the downloads will be started as minimized windows.  Also, if the individual windows are hidden, and this Download Status window is closed, the individual windows will be changed to be minimized instead of hidden.  (Otherwise it's very hard for you to stop or view the status of the downloads!)

•	  Turn Off Computer When Done*:  This toggle button/menu shows whether GetRight will turn off your computer when it has finished downloading.  If GetRight is in Automatic mode, then GetRight will turn off your computer when ALL files have finished.  If GetRight is not in Automatic mode, then GetRight will turn off your computer when all the files in progress have completed.

NOTE1:  If your computer does not support automatic shutdowns, then this will exit Windows.

NOTE2:  If you turn this on, it is a good idea to close any other programs that are running.  This is so the computer doesn't sit waiting for you to answer prompts about "Save changes to XXX before exiting?" in other programs.

•	   Hang Up When Done*:  This toggle button/menu shows whether GetRight will disconnect you from the Internet when files have finished downloading.  If GetRight is in Automatic mode, then GetRight will disconnect when ALL files have finished.  If GetRight is not in Automatic mode, then GetRight will disconnect when all the files in progress have completed.

NOTE:  This option is available if you are using either Windows Dial-Up Networking, or Other Networking Software (see Configuring-Internet)

• 	   Re-Dial If Disconnected*:  This toggle button/menu shows whether GetRight will try to redial and resume downloading if it is interrupted by the network connection being lost.  This is very useful if your Internet Service Provider (ISP) periodically disconnects you, or has time limits for being connected.  With this option enabled, GetRight will automatically redial and resume downloading without you having to do anything.

This is turned on when GetRight enters Automatic mode.  GetRight will use the options setup on the Internet configuration tab for redialing.

NOTE:  This option is only available if you are using Windows Dial-Up Networking or America Online.  While this redialing can work with America Online, it may not always detect that the connection was broken and redial, or it may delay several minutes before it detects that the connection was broken. (see Configuring-Internet)

•	   Obey Speed Limit*:  GetRight can be set to obey a "Speed Limit" so that it will only use a fixed amount of your modem's capacity.  This feature will allow you to download files with GetRight and still use your web browser without as much loss of performance.  This toggle button/menu shows whether GetRight is currently obeying the speed limit.

If you have not set a speed limit when this is pressed, the configuration form will display for you to set a limit.

See Configuring-Limits for information about setting this speed limit.

•	   GetRight Dialer*:  This may be used to immediately start the GetRight dialer.  (This dialer has the advantage over the regular Windows95 dialer of redialing if the line is busy.)  (Shortcut key:  Ctrl+D)

NOTE:  This option is only available if you are using Windows Dial-Up Networking (see Configuring-Internet)

 •	Set Priority*:  This menu contains several options for setting priority.  This priority will be used when GetRight is in either Automatic or Scheduled downloading mode.  The Highest priority items will be started to download before the lower priority items.

The current status of each item that is not currently downloading is indicated on the spreadsheet next to the filename:

 = Very High priority

 = High priority

 = Normal priority

 = Low priority

 = Very Low priority

 = Do Not Download priority

NOTE:  Priority is not used to give speed preference for items being downloaded at the same time.

(Top of page)

Advanced Menu*

•	Change Local Filename*:  If a file is not currently downloading, you may change the filename on your hard drive where the download is being saved.

•	Change URL*:  Enter a different web address (URL) for the file to be downloaded from.  This is useful if the server you started downloading from has been too busy to reconnect when you have tried later.

NOTE:  You may want to start a separate download and  test that the new server will support resuming before doing this so that your partial file will not be lost if the new server does not support resuming and GetRight has to start from the beginning.

•	Change Username and Password*:  Some servers require a username and password to login in order to download files.  You may use this option to set the username and password for many URLs at once.  A window will appear so you may enter the new values for the username and password.  The values you enter will be used for ALL the downloads you have selected.

NOTE1:  To avoid any security problems, GetRight does not display the current values in the window that appears or in any of the download windows.

NOTE2:  GetRight will accept and use usernames and passwords from URLs with the format ftp://username:password@ftp.xyz.com/filename

•	Alternate URLs*:  This is a much more sophisticated way to change URLs.

GetRight allows you to build a list of possible locations for the file to be downloaded.  GetRight will then transparently change between these different alternate URLs to download from the fastest server, or if servers are busy or if other problems occur.

These alternate URLs may be easily setup by downloading from TUCOWS or another popular mirrored site in GetRight's MIRRORS.LST file, downloading a "File Mirror List" file which allows GetRight to build this list of alternate URLs.  You also may use this option to view, add, or delete these Alternate URLs by hand.

NOTE:  If a file has alternate URLs, there will be an asterisk * before the URL on the spreadsheet.

•	Recover Lost Downloads*:  Use this option if GetRight somehow loses one of your downloads, or if you started downloading with another program  and want GetRight to finish downloading the file.  It first asks you to select the file on your machine that was incompletely downloaded.  You then are asked to enter the URL for where the file should be downloaded from.  GetRight will then add this file back into the download list.

NOTE:  If you use either type of log files (which is setup using the Advanced Configuration options) this option will search the log files to automatically find the URL for the lost download.  If you lose downloads often, you should setup to use a log file to assist in recovering them.

•	Clear All History Lists*:  This clears the contents of the "Enter New URL" drop-down list, and the "Recent Finished Files" and "Recent Finished URLs" menus from the Download Status File menu.  (Probably this will only used by people who don't want their parents/boss to know what they're downloading.  Maybe you shouldn't be downloading those kinds of things in the first place.)

(Top of page)

View Menu

•	Refresh:  Refresh the spreadsheet to be sure you are looking at the most current information.  [In Basic mode, this does exactly the same thing as the Regenerate Cache item under the Advanced menu.]

•	Show Monitor*:  This item will show the GetRight Monitor window.

•	View GetRight Log File*:  If you are using a log file (which is setup using the Advanced Configuration options) this option will open the log file using Notepad.

(Top of page)

Help Menu

•	Help:  This help page.

•	About:  About GetRight.  The about form also includes some statistics about what GetRight has done for you (number of files downloaded total MB downloaded, MB saved by resuming.)

•	GetRight Home Page -->:  This item will open the GetRight home page in your web browser.

(Top of page)

Toolbar*:

Right clicking on the toolbar will show a menu so you may hide or show the toolbar buttons (menu similar to the Edit->Toolbar menu).  You can use this to remove an item which you never use (such as the "Dialer" or "Speed Limit" buttons.)  The buttons are grouped into several categories and you may show or hide all the buttons in the category.

(Top of page)

Spreadsheet:

Right clicking on items on the spreadsheet will give you a menu of several of the choices from the menus described above.

Copy URL(s) to Clipboard:  (This is only available from Right clicking)  This will copy the URLs of all selected downloads to the clipboard.

Spreadsheet Columns:

Clicking on the header text for any of these columns will sort the spreadsheet by the data in that column.  Clicking the header text for a column will sort by that column in the reverse order.

•	Local File:  This column contains the status using the link icons (shown above) and includes the filename (minus the file path) of the file being downloaded to your computer.

Sorting Tips:  If you hold the CTRL key down when clicking on the header to sort by this column, GetRight will sort all the currently in progress downloads to the top.  If you hold the ALT key down when clicking on the header to sort by this column, GetRight will sort by the Priority of the downloads.

•	Resume:  This column contains Yes or No to indicate if the server supports resuming.  If Yes, a number is added to indicate the total number of times this file has been resumed.

•	Progress:  This column contains an indicator of how much of the file has been downloaded.  It will usually be a percent.

•	Total:  This column contains the total size of the file being downloaded.

NOTE:  The "units": bytes, KB, MB will vary depending on the size of the file.

•	Est. Time:  This is the estimated time remaining for this file.  This is based on the transfer rate the last time this file was in progress, so may not be completely accurate if the connection was busier (or less busy) at that time.

•	Address (URL) or Comment:  This is the address from which the file is being downloaded.  If an asterisk * is before the address, it indicates that there are Alternate URLs stored by GetRight.  If you have set a file comment, it will be displayed here instead of the Address (URL).

(Top of page)

Graph:

 In the lower right corner of the window (in the Status bar) is a graph that will display when files are downloading.  This graph indicates the total transfer rate of GetRight for the last 3 minutes (updates every 3 seconds).

This graph is useful to see if you are getting a consistent transfer rate, or if it is varying widely.

The highest value on the graph is the highest transfer rate while GetRight has been running this session.  If GetRight is closed and restarted, this will be reset.  (This is in case you get different connection speeds.)

(Top of page)


Config-Proxy
Proxy Tab - GetRight Configuration

 A Proxy server is needed by users who are behind a security Firewall.  The Proxy server enables these users to access the internet through the Firewall.  These settings are most commonly needed by businesses, though some ISPs will also use proxy servers.  If you are using proxy servers, and GetRight is not working correctly, the most likely problem is that something is not correct in these proxy settings.  (And it can often take a bit of trial and error to figure out what it is if you can't get your network administrator to help get these settings correct.)

•	Use proxy servers:  This checkbox is marked to indicate that you need to use proxy servers to connect to the Internet.  (If you use proxy servers and GetRight doesn't work)

If this is not checked, the Proxy Server sub-tabs will be hidden.

Proxy server settings can be quite complex, and generally require more knowledge about how your network is setup.  Hopefully you'll be able to accept the default entries, but if not, it may take some fiddling around to get a set of options that works best for your proxy servers.

If you use a proxy server and no servers will resume downloads for you.

HTTP Proxy

•	 server:port:  If you use a HTTP proxy server to access the web, enter its address here.  It must be of the form:  server.name:port   for example www-proxy.headlightsw.com:8080

By clicking the Find button, GetRight will attempt to automatically determine this information from your web browser's configuration.  You should be able to accept the value filled in for you.  (Or you can ask your network administrator.)

•	Use HTTP Proxy for FTP addresses:  This allows you to have GetRight use your HTTP proxy server for getting both HTTP and FTP addresses.  Try using this setting if GetRight is not able to download FTP addresses but is able to download HTTP addresses.  (But try using the Use HTTP protocol with FTP Proxy server option before trying this one.)  If this option is set, the FTP Proxy tab is not available.

NOTE:  Depending on your Proxy server, GetRight may not be able to resume FTP downloads with this option set.

•	Tell HTTP Proxy server to not use caches:  Proxy servers may save data in case someone else makes the same request.  The proxy server may believe that a request to resume a download at another point is the same as a previous request and return the wrong data.  Turn on this option to tell the proxy server to not use its cache and go get the data from the server again.

•	Login to HTTP Proxy server:  Some HTTP proxy servers require the use of a username and password.  If yours does, check this.  You may then enter the username and password.  You must check the checkbox for Password in order for your password to be saved since it is not highly encrypted.  If you do not fill in the username and password, GetRight will prompt you each time it is needed.

TIP:  If your proxy server does require a username, but not a password, then you should enter some text as a fake password so that you are not prompted each time GetRight would need the password.

NOTE:  The stored password will be scrambled so it is not easily readable, but is not highly encrypted.

•	Try alternate connect (if proxy server doesn't resume.):  Some proxy servers do not understand the resuming feature GetRight is using.  If you are not able to resume from any servers, try using this setting--but it's not guaranteed to work either.  If you get errors downloading from every HTTP server, then turn this back off!

NOTE:  if GetRight gets an error response from the proxy server that it doesn't recognize the different method, then GetRight will automatically turn off this checkbox.

FTP Proxy

•	 server:port:  If you use a FTP proxy server to access the web, enter its address here.  It must be of the form:  server.name:port   for example ftp-proxy.headlightsw.com:2121

By clicking the Find button, GetRight will attempt to automatically determine this information from your web browser's configuration.  You should be able to accept the value filled in for you.  (Or you can ask your network administrator.)

•	FTP Proxy type:  This drop-down list lets you select from different FTP Proxy server types.  Most FTP Proxy servers use type "USER with no login".  Ask your network administrator if this setting does not work.

NOTE:  The "CONNECT Address" type is really for use if you are using an HTTP Proxy server as an FTP Proxy.  If you set this option, you should make sure that the server:port entered is for an HTTP Proxy.  With this option, you should also check the "Use alternate (PASV) ftp download method" option.

•	Use HTTP protocol with FTP Proxy server:  This allows you to have GetRight use the HTTP protocol when downloading FTP addresses through your FTP proxy server.  Try using this setting if GetRight is not able to download FTP addresses.

NOTE:  Depending on your Proxy server, GetRight may not be able to resume FTP downloads with this option set.

•	Login to FTP Proxy server:  Some FTP proxy servers require the use of a username and password.  If yours does, check this.  You may then enter the username and password.  You must check the checkbox for Password in order for your password to be saved since it is not highly encrypted.  If you do not fill in the username and password, GetRight will prompt you each time it is needed.

TIP:  If your proxy server does require a username, but not a password, then you should enter some text as a fake password so that you are not prompted each time GetRight would need the password.

NOTE:  The stored password will be scrambled so it is not easily readable, but is not highly encrypted.

•	Use alternate (PASV) FTP download method:  This sets GetRight to have itself setup the data connection for FTP transfers.  (The default is for the server to setup the data connection.)  If you have trouble doing FTP downloads with GetRight and a proxy server, try setting this as a last resort.  (Or if you know this is the type of proxy server setting that you need.)

Exceptions:

•	 Do not use proxy servers for connecting to servers:  For some people who need to use a proxy server to connect to the Internet, they do not need to use a proxy server to connect to their Intranet (usually other servers for the business.)  This allows you to have a list of servers that do not require using a proxy server.

(Main Configuration Help)


Config-General
General Tab - GetRight Configuration

This is for setting up several miscellaneous items.

•	Use "Basic" interface.  Many options will be hidden!:  This allows you to turn on Basic mode.  Many of the advanced options will be hidden to make the GetRight user interface simpler and less confusing to use.  That includes hiding this many-tabbed Configuration window!  In Basic mode, the Configuration Wizard is used instead.  You may return to the Full mode from either this Configuration window or the Configuration Wizard.

The top portion of this form lists events that occur within GetRight and lets you associate a sound with each of these events.

Events:

•	Address Added:  When a new address is added to GetRight's download list.

•	Address Added as Alternate:  When a new address is added as an alternate address to an item in GetRight's download list.

•	Alternates Calculated:  GetRight was able to calculate alternate addresses where a file may be downloaded.

•	Connection Broken:  When GetRight loses the network connection to a server where it is downloading

•	Connection Error:  When there was some error making a network connection to start downloading the file.

•	Connection Timed Out:  When GetRight was not able to start the transfer because the server did not respond.

•	Dialer Connected:  When the GetRight dialer has connected to your Internet Service Provider.

•	Dialer Connected; Downloading:  When the computer has dialed the Internet, and "Always start automatic downloading when connected" is enabled on the Internet configuration tab.

•	Dialer Did Not Connect:  When some error occurs when GetRight is dialing your Internet Service Provider.

•	Dialer Starting to Dial:  When GetRight is starting to dial your modem.

•	Finished All Downloads:  When everything in progress has completed.

•	Finished Download:  When GetRight has finished downloading each file.

•	Prompting to Hang Up:  When GetRight shows the prompt that gives you 30 seconds to cancel hanging up your modem.

•	Prompting to Login:  When GetRight shows the prompt to ask you for a username/password to login to the server.

•	Prompting to Turn Off Computer:  When GetRight shows the prompt that gives you 30 seconds to cancel turning off your computer (or shutting down Windows.)

•	Re-Using FTP Connection:  GetRight finished downloading a file, and another file is on the same FTP server, so GetRight is switching to download the next one from the same server.

•	Server Will Not Resume:  When a file being downloaded may not be resumed.  (If this sound is selected, it may cause the Start Downloading sound to not play--especially if this is a long sound.)

•	Start Downloading:  When GetRight has connected to the server and has started to download a file.

•	Start Downloading (Resume):  When GetRight has re-connected to a server and has continued to download a file that it had already partially downloaded.  If no sound is set for this, the Start Downloading sound will be played.

•	Starting Scheduled Download:  When GetRight starts downloading at a scheduled time.

•	Switch to Alternate Address:  When GetRight switches to continue the download from a different server.

Click the play [image] button to play the sound for a selected action.

Click the None button to clear the sound for a selected action.  No sound will be played.

Click the Use Default button to use the default Windows beep sound for the selected action.

Click the Browse... button to select a sound (.WAV) file to associate with the action.

•	EMail Address:  Many FTP servers require your email address to login to download files.  This email address will only be used for logging into FTP servers.

By clicking the Find button, GetRight will attempt to automatically determine this information from your web browser's configuration.  You should be able to accept the value filled in for you.  (Most FTP servers actually only check for some text followed by an @ sign, so you can safely leave the default getright@ and be able to log into most FTP servers.)

•	Registration Code:  This program is shareware.  You may obtain a registration code by registering this program with HeadLight Software.  (See Registration Form).  After entering a valid registration code, the "Shareware Reminder Windows" that periodically appears when starting a download will be removed.  Leave this field blank if you have not registered this program.    This field will disappear once you have entered a valid registration number.

(Main Configuration Help)


Configuration-Limits
Limits Tab - GetRight Configuration

This  tab allows you to set some of the limits that GetRight will use.

•	Download up to XX files at the same time:  When resuming or scheduling downloads, this controls how many files GetRight will try to download at the same time.  For a 28.8 modem connection 2-3 is probably the most you would want to download at the same time.

NOTE1:  This option is over-ridden if you select to resume multiple downloads by hand from the Download Status window.

NOTE2:  There are limits in many Windows network connection programs (WinSock's) so that you are usually limited to "only" about 13-14 files downloading at the same time.

•	Set new files to be downloaded later if GetRight is already working do download this many files:  If there are that number of downloads currently in progress, any new downloads added to GetRight's list will skip any Now/Later prompts and always be added for downloading later.

•	Up to XX files at the same time from each FTP server:

Up to XX files at the same time from each HTTP server:  These two are used to limit GetRight from download too many files from the same server at the same time.  These do not over-ride the "Download up to XX files at the same time" above.  These allow you to set a higher number in that box (such as 5 at once total) and keep GetRight from downloading all 5 from a single server.

This should help improve performance when downloading from busy servers and make some server administrators happier.  Some servers (particularly FTP servers) will limit the number of connections you may have at once anyway.

While some Internet connections can handle a large number of downloads at once, it is not nice to servers (and their administrators) to download large numbers of files from one server at the same time.

•	Speed Limit XX YY per second:  These items let you set a speed limit for GetRight.  GetRight will try to stay close to this limit when downloading (it probably won't hit this value exactly, but does get pretty close.)  This feature will allow you to download files with GetRight and still use your web browser without as much loss of performance.  A speed limit of 0 (in any units) is treated as no speed limit.

This textbox accepts only full numbers (no decimals) but by using the units, you can get the same effect.  1k is about 1000 bytes, and 1MB is about 1000k.  So to enter 2.5k, you should enter 2500 bytes.

NOTE1:  The "Always obey speed limit" item below, or the "Obey Speed Limit" menu/toolbar button on the Download Status window must be set for GetRight to obey this speed limit.

NOTE2:  Just to be sure:  this is an upper speed limit.  Setting this value to something higher than your modem's capacity won't do anything.  It won't turn your 2400 baud modem {bicycle} into a T1 {Porsche} by increasing the speed limit, sorry. :)

•	Always obey speed limit:  Whenever GetRight downloads, it will follow the speed limit set above if this is checked.  This may be temporarily over-ridden by using the "Obey Speed Limit" menu/toolbar button on the Download Status window.

(Main Configuration Help)


Configuration-Login
Login Tab - GetRight Configuration

Some servers require a username/password in order to download files.  You may setup a set of usernames and passwords here so you do not have to type them in each time you download from those servers.

Note:  While the stored passwords are scrambled so they are not readable, they are not strongly encrypted.  If you have concerns about security, you shouldn't enter any passwords here.

The top portion of this tab contains a report listing Server/Path, Username, Password with textboxes below so you may select one item to change, or add a new value.

•	Click on an item in the report to change its value or delete it (the buttons will be "Set" and "Delete").

•	Click a blank area in the report to add a new value (the buttons will be "Add" and disabled "Delete").

The Server/Path is used to tell GetRight where to use this username/password.  Adding a path to the server name should be used to indicate that different directories (such as those pointing to different user accounts) or different servers need different usernames or passwords to log in.  If a URL contains the text in the Server/Path entry, then GetRight will try the corresponding username and password.  If it does not work, GetRight will then try the next one in the list until it gets to the bottom of the list.

The Server/Path is optional, and if the Server/Path box is left blank, a asterisk " * " will be shown in the report indicating that this username/password should be tried at any server.   But it is not as efficient if GetRight has to try many username/passwords to find the one that works, so it is recommended that you do use this field where possible.

GetRight tries the username/passwords in order from the top to the bottom.  Use the Up and Down buttons to move the more common items you will use to the top of the list.

A sample:

Server/Path	Username	Password

ftp.xyz.com/users/jack	jack	2uphill

ftp.xyz.com/users/jill	jill	pail0water

ftp.abcd.com	hank	afterhomer

Registered users of GetRight are allowed up to 100 entries.  Unregistered users are limited to just one.

Note1:  GetRight does not recognize asterisks " * " or question marks " ? " within other Server/Path entries (but .xyz.com in the list will be treated as *.xyz.com*)

Note2:   The text may be anywhere in the URL, GetRight just looks to see if the text is there.  So a Server/Path entry of "xyz" would be found in the URL  "ftp://ftp.abcd.com/pub/texyz10.exe".  This shouldn't be a problem, since GetRight will just try the next one if it doesn't work.

(Main Configuration Help)


Config-Country
File Mirrors Tab - GetRight Configuration

GetRight can track many possible addresses (URLs) from where a file may be downloaded.  GetRight will find the fastest of the different addresses to improve your download speeds.  Also, if one server is busy, or if GetRight is unable to reconnect to a server, it automatically switches to use a different alternate URL for the file.

Calculating Alternate Addresses:

GetRight uses both a list (MIRRORS.LST) to quickly calculate alternates for some files.  An other method, but that may find additional mirror sites is FTP search--there are some sites (ftpsearch.ntnu.no) that can be used to search to find many places where a file can be downloaded.  GetRight can automatically use one of these sites to calculate other addresses.  This will find alternates for more files, but can take a bit longer to do.

GetRight can handle several "Mirror List" file formats:

•	GetRight's own file type, called a File Mirror List (.FML).  (One software site that has FML file mirror lists available for ALL their downloads is FileMine.  www.filemine.com )

•	Download.Com's "Download Manager" file type (.VSL).

•	Or if you start downloading from one of the most common mirrored sites, or any of their mirrors (such as SimTel.Net or TUCOWS) GetRight will automatically calculate a list of alternate addresses.  GetRight uses a MIRRORS.LST in the directory where it is installed to calculate these alternates.

You may download an updated MIRRORS.LST file by selecting the "Download Updated Mirror List" under the "File" menu on the Download Status form.  This MIRRORS.LST file contains documentation on its structure so you may add other customized lists of mirrors.  If you create a mirror sets that would be useful for other people, please contact mjb@headlightsw.com so it may be added.

•	If you have a list of mirror sites you commonly use, you may add them to the MYMIRROR.LST file in the directory where GetRight is installed.  This MYMIRROR.LST uses the same format as MIRRORS.LST.  This file will not be over-written by downloading an updated mirror list or re-installing/upgrading GetRight.

In order to make this process work even better, GetRight will select its list of alternate URLs based on geographic locations--a closer server should offer faster download speeds than one that is located on the other side of the Earth.  GetRight will select servers based on those that are located in your country, then those in your country list (where you can list the closest other countries), your Continent, then the rest of the Earth.

•	Country Code:  The country code for Internet addresses in your country.  For example, "us"=United States of America, "jp"=Japan, and "be"=Belgium.  Servers in your country will be given first priority when GetRight calculates a list of alternate servers.   List of All country codes.

•	Country List:  A list of other countries.  This should normally be used to list other countries that are closest to you.  Countries in this list will be given second priority when GetRight calculates a list of alternate servers.

Separate countries codes with a space.  List of All country codes.

 •	Continent:  Contains a drop-down list of all the continents.  Countries in your continent will be given third priority when GetRight calculates a list of alternate servers.  (Yes, few people will actually need "Antarctica" but it's there for completeness--at least I didn't add "Moon" or "Orbit" :-)

•	 Preferred servers:  This option enables you to enter a list of favorite servers.  GetRight will give preference to these server when selecting the URLs and when changing between URLs.  It is recommended that servers entered here should support resuming, should be mirrors of common download sites, and should be geographically close to you.

Servers in this list should be separated by spaces.

•	If filename for new URL is the same as an existing URL's filename, add the new one as an alternate address for the file:  Pretty much as it says.  For example, if you have http://www.getright.com/grsetup.exe in your download list already, and start a new URL that points to a file with the same name (grsetup.exe in this case, such as http://www.xyz.com/files/grsetup.exe) it will be added as an alternate address, instead of being added as a separate file to be downloaded.

•	Find fastest server:  This option allows GetRight to calculate the fastest server for downloading in the list of alternates.  Once it has found the fastest server in the list of alternates, it will switch to downloading from that server.

•	Recalculate fastest server every XX minutes:  (Enabled when Find fastest server is checked.)  When this option is checked, GetRight will periodically recalculate the speeds to all the servers.  If the current server is no longer the fastest server, GetRight will switch to the current fastest server.

NOTE:  Setting a small time for this could actually slow down the download--since GetRight could easily spend time reconnecting to different servers each time it recalculates the speed.

NOTE2:  If the current server is nearly as fast as the fastest server, GetRight may not change servers.  You may always pick the button to the right of the URL field on the individual download forms if you wish to change to a different server.

•	Automatically calculate and add alternate URLs:  If you start downloading from one of the most common mirrored sites, or any of their mirrors (such as SimTel.Net or TUCOWS) GetRight can automatically calculate a list of alternate addresses.  GetRight uses a MIRRORS.LST and MYMIRROR.LST in the directory where it is installed to calculate these alternates.  You may uncheck this item if you do not wish this to occur.

NOTE: You may download an updated MIRRORS.LST file by selecting the "Download Updated Mirror List" under the "File" menu on the Download Status form.  This MIRRORS.LST file contains documentation on its structure so you may add other customized lists of mirrors.  If you create a mirror sets that would be useful for other people, please contact mjb@headlightsw.com so it may be added.

NOTE2:  For web-page type files (.HTM, .GIF, etc) GetRight will not bother to check the MIRRORS.LST file for alternate addresses since these files are specific to just one web server.  GetRight will check the MYMIRROR.LST for alternates in case you have some special needs.

•	FTP search to find alternates:  GetRight can automatically use one of the sites which allow searching for many different addresses where a file may be found.  This is more likely to find alternate addresses for a file, but can take a bit more time (usually has to download between 25k and 40k).  You may pick which server to use for these FTP searches.  If you click the magnifying glass button, GetRight will ping these servers to choose the fastest for you from the drop-down list.

GetRight will always have a "FTP Search" checkbox on the "Save As" window so you may control if each file should use FTP searching or not.  If this is not checked, then GetRight will never have it checked by default.  If this is checked, then GetRight will fill a default checked value in that checkbox on the "Save As" window when both the filename contains two numbers, and the file type is not one of the "Skip" types on the Monitor configuration tab.  You can of course change state of the checkbox on the "Save As" window as you desire.

WARNING:  GetRight does check that the files for alternates are exactly the same size as the original file, but it is always possible that some files will be the same size, but do not contain the same contents (DISK1.ZIP is a definite candidate for this).  This could cause GetRight to end up with a corrupted file after the download if the files did not have the same contents, but were the same size.  If you want to be completely safe from this happening, do not use FTP Searching, or only use it when the filenames are not likely to conflict with names someone else might have used.

FILENAMES:  The file name must contain two numbers to avoid searching for alternates of things like "SETUP.EXE" or "DISK1.ZIP".  Most programs to download do contain a number as part of a version in the filename.  If the file name is used by more than one unique file (like "DISK10.ZIP" is), this FTP searching could produce incorrect alternates.

The FTP Search server does give an approximate file size to GetRight.  If this isn't close to the size of the file from the original URL, the alternate(s) will be removed when GetRight connects to the original URL.  If GetRight connects to any alternates later that aren't really exactly the same size as the original URL, it will remove those alternates.

If you can tell from the filename that it's probably not going to find the right alternates (like "FILE10.ZIP"), it's better if you just uncheck the FTP searching on the "Save As" window for that file.

NOTE:  If you want to force GetRight to FTP search for mirrors, even after it has started downloading, click the button to the right of the Address/URL box on the individual download windows.  The menu will contain an item to recalculate alternates.  When doing this re-calculation, GetRight will not do the first quick check to see if files are close to the same size--in case the FTP Search server sent the wrong size.

•	Switch servers if getting less than XX bytes per second:  This option enables GetRight to change to a different server if the server is sending data very slowly.  If the average for several minutes is less than the number of bytes per second entered, then GetRight will switch to an alternate URL.

The number of bytes per second to enter will vary depending on your modem, telephone lines, patience, etc.  For a 28.8 modem, which usually transfers at about 2.5K/sec (or about 2500 bytes per second), a value of 500 bytes per second (or about 1/5th the capacity) might be correct.  You will need to watch your transfer rates and pick an appropriate value (multiply your average K/sec value by 200 to get a reasonable value to use here.)

(Main Configuration Help)


Config-Internet
Internet Tab - GetRight Configuration

This tab has three radio buttons at the top.  Depending on which is selected, the bottom portion of the form will show different information to be setup.  These settings allow GetRight to connect to the Internet to start a scheduled download, or to disconnect from the Internet when it has completed downloading files.

Always connected to Internet (or do not try to connect.):

•	 Use this option if either you have a full time connection to the Internet, or you do not want GetRight to try and connect to the Internet itself.

Connect using Windows Dial-Up Networking:

Plays sound "Dialer Connected" when the dialer connects to Internet.

Plays sound "Dialer Did Not Connect" when the dialer did not connect.

•	Dial-Up connection to use:  Use this drop-down list to select an existing Windows Dial-Up Networking option.

NOTE:  The special value "(GetRight Should Never Dial)" is used to indicate that you use Windows Dial-Up Networking (so that GetRight can hang up the modem when done, or do scheduled hang ups) but that GetRight should not dial itself--you should select this option if you use some other redialing program instead of GetRight.

Also, while it is enabled, the Scheduled downloading may not function correctly if you have "(GetRight Should Never Dial)" selected and you are not connected to the Internet at the time the scheduled download starts.

•	Username and Password:  Enter the username and password needed to log into your Internet Service Provider (ISP).  If you leave these fields blank, you will be prompted when GetRight dials to make the connection.  If you are using the scheduling features, you will need to enter the username and password so GetRight can connect when you are not sitting at your computer.  (For Windows NT users, this is not needed, so is not visible.)

•	Redial if the line is busy:  Pretty self explanatory.  If the line is busy, GetRight will redial.  (For Windows NT users, this is not needed, so is not visible.)

•	Reestablish Connection window title:  This is the window title for the window that appears when the Windows Dial-Up Networking is disconnected (such as by unplugging the phone line from the wall.)  The default will be correct for English versions of windows, but will need to be changed for non-English versions.

This text must be correct so that GetRight can close that window an free up the modem--otherwise you'll get "Device in Use" error messages when GetRight tries to redial.

Connect using Other Dial-Up Networking software:

This lets you setup other Internet dialing software which use different methods to dial or hangup the modem.  If it is not one of the pre-defined items under the "Others" button, this will take more knowledge for you to setup.  Even when other dialing software is setup correctly in GetRight, GetRight's "re-dialing if you are disconnected" feature will not work--but all other GetRight dialing features will work.

Others:   This button will show a menu of other Internet dialing software that have been pre-defined with settings for GetRight.  Select the item from the menu to fill in the settings for that Internet dialing software.

Note for America Online:  While GetRight can make America Online dial, hang-up, etc, it does not work nearly as well as when you are using Windows Dial-Up Networking.  For example, extra message windows from America Online (such as special offers you are shown when you login) can cause GetRight to not detect that AOL has dialed and connected OK.

Note2:  It is possible the settings will not be correct for all versions, or other language or country versions of the Internet software (for example, the "America Online" item has been tested with the US version of AOL 4.0 and 3.0, but not other country's versions of AOL).

•	Internet connection window title contains the text:  This must be a string of text that is in the window title that should only appear in the title of your other networking software.  "XYZ Connected to Internet" would be a good entry, while "in" would not.  This is used to tell when the other software has finished connecting, and to find which window needs to be closed to hang up (if setup below.)

•	Connect if needed; to connect, run the command/script:  Check this box to have GetRight run your other network software to start a connection.  You must enter or select the correct command in the box below.

•	To disconnect from the Internet

•	Close the Internet connection window to disconnect:  This option will close the window containing the text setup above when it is time for GetRight to disconnect.

•	Run the command/script to disconnect:  You must enter or select the correct command in the box below.

Other options:

•	Always start automatic downloading when connected:  Whenever your computer connects to the Internet, GetRight will start "Automatic" downloading.  This would be useful if you want to keep downloading parts of a file whenever you are connected to the Internet.

Plays sound "Dialer Connected; Downloading" when this is triggered.

NOTE1:  This is available when you are using any network connection software, but it generally works better if you are using Windows Dial-Up Networking.  Depending on the network connection software you use, it is possible that GetRight checking to see if you are connected could cause your modem to dial.  When you are not connected to the Internet, click the "Test" button to see if this causes your modem to dial.  If your modem dials, don't turn on this item.

WHY:  [If you want to know why:  If you aren't using Windows Dial-Up Networking, GetRight tries pinging your proxy server (if you have one) or one of the servers that has files to download--if it responds, GetRight assumes you must be connected to the Internet.  This method should work with any Winsock even without you setting up other things--so it will work for "Basic Mode" users too.  But some Winsocks detect when you try to connect and will dial your modem automatically.]

NOTE2:  This will start GetRight's Automatic downloading even if GetRight is not the program that dialed the Internet.  This is good for the person whose files are being downloaded, but could be annoying for other people who share the computer because GetRight will start downloading no matter what program you use to dial.

WARNING:  Be careful when using this setting with the Redial if Disconnected option on the Download Status window turned on.  If both these are set, when someone dials (using any dialing program) GetRight will redial and continue downloading after they hang up (even if they hang up normally).  You might want to use the "(GetRight Should Never Dial)" in the Dial-Up connection to use above if you use another dialing program that will redial by itself.

(Main Configuration Help)


Config-Connections
Connections Tab - GetRight Configuration

This allows you to setup several options for what to do if there are problems with the connection to a server while GetRight is downloading.  For most of these, you should be able to accept the default values.

Timeouts

•	Timeout connection attempts after XX seconds:  GetRight will return an error if it does not get a response from the server in the entered amount of time.  Change the default if your Internet connection needs more time to make connections.

•	Stop and Resume if no data received for XX minutes:

Or XX minutes if the server does not resume:  Sometimes a download will stop without being disconnected.  Enable this option and set a number of minutes so that GetRight will automatically stop and reconnect to the server.  This is very useful to "kick-start" a stalled transfer without you having to do anything.  This "kick-start" timeout can be set differently for servers that will resume transfers vs. ones that must be restarted from the beginning.

Miscellaneous

•	Rollback XX K on resumed connections:  Because some data may have been corrupted when GetRight was disconnected, this allows you to backup a little bit and re-get a small amount of data to be sure that no errors are in the file on your computer.  It is suggested that this be the about number of kilobytes (K) downloaded in 2 seconds, which will depend on the speed of your Internet connection.  For most modems, the default of 4K is fine.

•	Re-Use FTP connection if more files are on the same server:  Some busy FTP servers can be difficult to connect with to download files.  Once GetRight has connected to a FTP server, it can re-use the same connection to download several files from the same server without having to reconnect for each individual file.  This option tells GetRight whether to re-use FTP connections or not.  Re-using a FTP connection will over-ride many of the other options--such as all the files on the server will be downloaded, ignoring the Priority of other files that are on different servers.

•	When downloading, Ping to help keep connection alive:  Periodically pinging a server can help some a few people from being disconnected from the Internet by their ISP.  GetRight will periodically ping each server from which it is downloading.

NOTE:  This will not always prevent you from being disconnected; but it may help some users whose Internet Service Provider disconnects after a period of inactivity--where somehow it doesn't detect that downloading in progress means it is active.

Retrying

•	 Assume server login or timeout error means server is busy:  Many popular FTP sites have a limit on the number of users who may be downloading files at the same time.  This allows you to set GetRight to automatically "redial" the server until it successfully connects or reaches the maximum number of times it should retry.    If this option is not set, GetRight will prompt you to see if your username or password is not correct.

NOTE:  With this option set, if your username or password are not correct, GetRight will NEVER connect and will continue attempting until it reaches the maximum number of times it should try to reconnect.

•	Try to reconnect after XX seconds:  Enter the number of seconds that GetRight should wait before attempting to contact the server again.

NOTE:  While you can enter a value as low as 5 seconds, it is more friendly to other Internet users (and the server you are trying to download from) if you set this to a larger value and are not continually trying to connect to a busy server.  If a server is busy, you may be much better off just waiting and trying at a different time of day when the Internet is less busy.  The GetRight scheduling options can help you by scheduling downloads at times that are less busy.

•	Try to reconnect up to XX times:  You may set the total number of times that GetRight will try to reconnect to a busy server.  Set this option so that GetRight will give up and not attempt to reconnect forever.  GetRight may attempt up to reconnect up to 9999 times.

WARNING:  You should set these numbers to a reasonable combination if you are using GetRight's scheduled downloading features--otherwise GetRight could try to connect all night if a server was down or very busy!

•	If connection is broken, try to reconnect and continue:  This controls whether or not GetRight will attempt to reconnect if it is disconnected.  This will often work to automatically resume downloads from random internet/server disconnects.  There's probably no reason to ever turn this one off.

(Main Configuration Help)


Config-Clipboard
Monitor Tab - GetRight

GetRight monitors the contents of the clipboard to see if a web link is copied into the clipboard.

When a web link (URL) is copied to the clipboard, it automatically triggers GetRight to startup and get the file.  Use these options to configure how GetRight does this.

If you are a Netscape or Microsoft (4.0) web browser user, these same settings are used to start downloads with GetRight from within the web browser.    Opera Web Browser Users, please see:  http://www.getright.com/opera.html  for similar web browser monitoring!

•	Monitor Clipboard:  When this option is selected GetRight will monitor the contents of the clipboard to startup GetRight to download a file.  When text for a correctly formed URL is copied to the clipboard, GetRight will process it to see if it should download the file.

•	Monitor clicks in Netscape Communicator/Navigator:  GetRight will be automatically triggered by Netscape to download the file types setup below.  Using GetRight with this is as simple as using your web browser.

If you get any prompts asking you about whether GetRight should download a file type, respond as soon as possible--otherwise you can cause a timeout message in Netscape.

NOTE:  If you change this value, you will need to close and restart your web browser for it to work properly.

•	Monitor clicks in Microsoft Internet Explorer (4.0 or higher):  GetRight will be automatically triggered by Internet Explorer to download the file types setup below.  Using GetRight with this is as simple as using your web browser.

With Internet Explorer, GetRight can not prompt for unknown file types.  If the file type is not in the "Automatic" types setup below, then GetRight not intercept the click and it will be handled by Internet Explorer.

NOTE:  If you change this value, you will need to close and restart your web browser for it to work properly.  If you have Internet Explorer's "Shell Integration" enabled, you may need to reboot for this setting change to take effect.

Temporarily disabling all monitoring:

•	You may temporarily disable all monitoring (both clipboard & all web browsers) by using the "Clipboard and Click Monitoring" menu item from Right clicking on the GetRight [image] logo in your tray icons.  If there is a check by this menu, then your monitoring as setup here is enabled.  If there is no check, then GetRight will not monitor any of these.  You will not need to restart your web browser for this change to take effect.

Tips that work with either Netscape or Microsoft web browsers:

•	If you hold the SHIFT key when clicking a link, GetRight will not catch any link that is clicked.   This is useful for some forms or search engines that look like .EXE files to GetRight.

•	If you hold both the CTRL and ALT keys when clicking, GetRight will get any link that is clicked.  This is useful to download a web page so that GetRight's web page processor will show a list of all the links available from that web page and let you pick files to download.

•	Automatically start downloading files of types:  This textbox contains a list of file types which GetRight will immediately start to download.  The defaults are the most common download types--executable files and several different compression types.

You may add more file types (file extensions) by entering them in the textbox.  Be sure to use the format .XXX  ? and * wildcards are OK.  The period is required.  Semicolons are not needed anymore, but won't cause any problems if it is there.  Make sure there is a space or return between items in the list.

NOTE1:  If GetRight prompts you about getting a file type and you select "Yes; and always get this file type with GetRight", then that type will automatically be added to this list.

NOTE2:  With the click monitoring for some types (.GIF, .HTM, .HTML, .JPG, .JPEG), they will not be downloaded by GetRight even if they are in this list of types to get.  Otherwise, if .GIF was downloaded by the click monitoring, GetRight could try to download every image on every web page you opened!

•	Ignore all clicks for server(s):  GetRight's click monitoring can be confused by servers that use forms or other URLs that appear to be EXE files.  GetRight may incorrectly catch these clicks and download the web page.  (A quick, temporary solution is to hold the SHIFT key when clicking on these URLs to tell GetRight to ignore the click.)  If you frequently use a server that does this, you can add the server name to this list so that GetRight will ignore all URLs located on that server.

You should not use any thing except the server name (no paths.)  You should use semicolons or spaces to separate servers if you have more than one.  For example:  www.abcde.com; www.xyz.com;  ? and * wildcards are OK.  (The wildcard checking isn't perfect, use something like *.abcde.com to work best.)

•	Prompt for downloading all other file types except:  GetRight will prompt you to see if you want to download most other file types (those are not specified in the "Automatically start" list.)  But not all types should be downloaded by GetRight--for example web pages that you wish to view in your web browser.  You may set a list of types which GetRight will not prompt you about downloading by entering them in the textbox.  The defaults are the most common "browser viewable" types--web pages, text files, and images.

You may add more file types (file extensions) by entering them in the textbox.  Be sure to use the format .XXX;    ? and * wildcards are OK.  The period is required.  Semicolons are not needed anymore, but won't cause any problems if it is there.  Make sure there is a space or return between items in the list.

NOTE1:  If GetRight prompts you about getting a file type and you select "No; and don't ask about this file type again", then that type will automatically be added to this list.

NOTE2:  When using the click monitoring with Microsoft Internet Explorer, GetRight can not prompt you, so it will treat any file types not in the Automatically start downloading files of types box as files it should not download.

•	Forward skipped types and show in browser:  This option allows GetRight to automatically make the file types it will never prompt to download (such as .HTML web pages) show up in your browser as soon as they are copied to the clipboard, without you having to switch to your web browser and paste the text from the clipboard.  For example:  with this option selected, if you copy a web link (URL) such as http://www.headlightsw.com/index.html to the clipboard, GetRight will make your browser switch to that page--without you having to do anything in your web browser.

If your web browser is not running, it will be started to show the selected page.

()


Config-SaveAs
Save To - GetRight Configuration

This lets you setup default directories where files should be saved on your hard drive.

The radio buttons at the top control how the default directory should be setup.  Depending on which one is selected, the bottom section of the form will change.

•	Remember last directory used:  Each time you are prompted where to save a file with GetRight, the last directory where you saved a file will be shown as the initial directory.

•	One default directory for all downloads:  Use a single default directory for all files.  Whenever you are prompted where to save a file with GetRight, this directory will be used.

∗	A textbox will be shown where you may type in a directory, or click the "Browse..." button to pick the directory.

•	Default directory by file type:  Depending on the type of the file, different default directories may be setup.  For example you could use this to save .EXE files to C:\INSTALL and .WAV files to C:\SOUNDS.

∗	The report list contains the file types (extensions) and default directories with textboxes below so you may select one item to change, or add a new value.

∗	Click on an item in the report to change its value or delete it (the buttons will be "Set" and "Delete").

∗	Click a blank area in the report to add a new value (the buttons will be "Add" and disabled "Delete").

You may enter several types for one directory by separating the extensions with semicolons, such as:  .EXE;.ZIP;  You may also use either ? or * wildcards in these extensions, such as: .HTM*  The case (uppercase vs lowercase) of the text is ignored.  A beginning * is not needed.  (use .EXE instead of *.EXE).

NOTE1:  To handle any other files that do not fit the specific types you set, use special file type of DEFAULT  Any types that do not match any of your types will use the DEFAULT item's directory.

NOTE2:  If no extension is found that matches the file type, and no DEFAULT file type value is found, GetRight will use the last directory used.

•	Generate directory from download information:  Subdirectories will be created whose name contains some information about the download.  All subdirectories will be created under a parent directory.

*	Parent Directory:  The directory under which all the other directories will be created.  Type in a value, or click the "Browse..." button to pick an existing directory.

*	Server Name:  The server name for the download is created under the parent directory.  If the server name begins with ftp. or www. then those will be removed before the directory is created.  So downloading a file from either www.getright.com or ftp.getright.com would create the directory \getright.com\ for saving the files.

*	Current Date:  The date when the download is started will be used as the directory name.  The format used is Year-Month-Day, so Christmas 1998 would be \1998-12-25\.  Or January 1st, 2000 would be \2000-01-01\.

*	File Extension (Type):  The file extension (or type) of the file is used, so setup.exe would create the \exe\ directory, or file1.zip would create the \zip\ directory.

•	Use default name and do not prompt for file name:  This causes GetRight to skip prompting you for the filename, and automatically uses the default name (if a file with that name does not already exist in the directory.)  For example, if you were downloading http://www.headlightsw.com/faq.html, GetRight would automatically save the file with the name faq.html (or faq.htm if you are using Windows 3.1) into your default directory and would not prompt you at all.

This may be used with the One default directory for all downloads or Default directory by file type or Generate directory from download information options.

NOTE:  When a new file is downloaded by GetRight, the suffix .GetRight will be added to the filename on the disk to indicate that the file is not complete.  When the file finishes downloading, then it will automatically be renamed to remove the .GetRight.  From a user perspective looking at GetRight, this is invisible--it removes the .GetRight for prompts and for displaying.  But it will be visible if you look at the files in the directory while they are being downloaded.  You may turn off this feature and not add .GetRight to your partial files on the Advanced configuration tab.

(Main Configuration Help)


Config - When Done
When Done - GetRight Configuration

This lets you setup what GetRight does when it finished downloading each file.

•	When finished getting file, close GetRight download window:  This controls whether or not the GetRight status window will close when the file has completed downloading to your computer.

NOTE:  If you are in "Scheduled" or "Automatic" download mode, or if the window is hidden or shown as a tray icon, the windows will be closed even if this item is not set.

•	Virus Scanner program to use:  This contains the filename and path for a program to be started when GetRight completes downloading every file.  The local path and filename of the file GetRight has downloaded is appended to this when the program is run.  This program would normally be a virus scanner, but could actually be any program you want (such as WinZip).  Click the Browse button to select the program, or click the "Search" button to automatically calculate your virus scanner.  Or type in the filename and path.

You may also enter any other command line parameters for the program being run.

Common Virus Scanner Values.  (Your path may vary):

McAfee AntiVirus: C:\Program Files\McAfee\VirusScan95\scan95 /AUTOSCAN /NOSPLASH

Norton AntiVirus:  C:\Program Files\Norton AntiVirus\navw32.exe

NOTE:  Most newer virus scanners offer some type of "automatic" protection and scan files when they you start to run the file, etc.  This having GetRight send the file to a virus scanner can help double check and give you peace of mind, but may not really be needed if your virus scanner does this.

•	File types to send to Virus Scanner when finished downloading:  This is a list of file types that need to be checked for viruses.  Make sure you use the format .XXX;  Not all files really need to be scanned (such as images or sounds) but if you put a * in this box, every file will be scanned.

•	File types to Open (View) when finished downloading:  This is a list of file types that should be opened when they finish downloading (for example a sound file would be played by your default sound-player).  Make sure you use the format .XXX;  If you put a * in this box, every file will be opened.

Some good contents for this box (which you can cut-and-paste into the box):

.GIF; .JPG; .JPEG; .JPE; .WAV; .MOV; .MP3; .MPE;

NOTE:  Be aware that opening .EXE or other files which could contain a virus is not a good idea.  Your virus scanner may not have had time to find or remove the virus before a .EXE file is run, so you should usually NOT automatically open all types (*) or programs (.EXE;).

NOTE2:  If GetRight is currently setup to shutdown the computer when it is done downloading, it will Not open the files.  This is so the computer doesn't sit waiting for someone to click "OK" in some other program before it finishes shutting down.


Config-Advanced
Advanced Tab - GetRight Configuration

Some other fancy options for the serious downloader.

•	Minimize to Tray Icon (and startup as Tray Icon):  Selecting this option will cause GetRight to start as a Windows 95 tray icon in the Start bar.  Also, whenever the GetRight Link Drop window is minimized, it shows as a tray icon.

Click the button to the right of this to pick from a few different tray icons.  Clicking will change the current tray icon so you can see what it will really look like.  [run the GetRightMoreConfig program in the directory where GetRight is installed for an easy way to set to Any icon file!]

NOTE: GetRight can not accept drag-and-drop links when it is a tray icon, and must be restored before you may drag-and-drop to the GetRight window.  It will work correctly for clipboard or web browser monitoring when it is minimized to a tray icon.  This setting will not do anything and should not be used with Windows 3.x style user interface.

•	Start downloading files immediately:  GetRight can either add files to its download list and then start downloading the file, or it may just add the file to the list so that you may start downloading it later.  Uncheck this option if you wish to have GetRight only add files to your download list, but not start downloading the files (or prompt, depending on setting of the next item).

•	Prompt to start downloading files:  If you turn off the "Start downloading immediately" option, then this is enabled so you can have GetRight prompt you before starting any downloads.  This lets you say which files to start immediately, and which to just add to the download list to be done later.

•	Add .GetRight to filenames until done downloading:  By default, GetRight will add .GetRight to each filename that it is in progress downloading.  This allows you to easily see that a download has not yet completed downloading.  If you do not want this to happen, you may turn it off with this option.

•	Use Cookies from web browser:  Some web sites require cookies in order to download files from their server.  This option allows GetRight to read cookies saved by your web browser.  GetRight will not save or change any cookie information in your web browser's cookies.  (Most sites that require cookies to download require that you send a cookie value that was previously sent to your web browser.)

This reads either Microsoft Internet Explorer or Netscape Navigator/Communicator cookies.

•	Expert mode; no delete or cancel confirmation prompts:  Avoid a few of the "Are You Sure?" type prompts.  For the individual download windows, this causes clicking "Cancel" or closing the window to assumes you do want to finish the download later.

•	Always do "Automatic" downloading when start a new download:  Whenever a download starts, GetRight will enter "Automatic" downloading mode.  This will make GetRight start more downloads when those in progress are finished and obey the limits for the number of files at once.

NOTE:  Since "Automatic" mode is also intended for downloading with no user needed (or available), GetRight will also show no error messages or other user messages--and just skip to the next download if there is an error.  This also will make the Web Page Processor not prompt about processing the page!  But you may now use command line parameters to process a page on your hard drive.  From a DOS prompt, enter GETRIGHT /? for a list of all command line items and options.

•	Use smaller download windows:  Makes the individual download windows about one third smaller (less images and animations too.)

NOTE:  Changing this will not change any download windows that are currently open.  You must close and re-open any download windows for the size change to take effect.

•	Download Windows As:    This item lets you pick how the individual download progress windows should be displayed.  If changed, any current downloads will be changed to the display method you pick here.  (You may also change this on the Download Status window.)

Normal Window = Show as a regular window.  (In Basic mode, all windows are shown as normal windows.)

Minimized Windows = Regular window, but it starts minimized in the taskbar.

Tray Icons = As a small icon in your tray icons in the taskbar.  Right clicking on the tray icon will show a menu to allow you to restore the larger window, pause/resume the download, or close the download.  Double-clicking on the tray icon will restore the normal window.

Hidden (on Download Status) = Windows are not visible.  You can view the information on the Download Status window.  Note that if the Download Status window is not open then the downloads will be started as minimized windows.  Also, if the individual windows are hidden, and this Download Status window is closed, the individual windows will be changed to be minimized instead of hidden.  (Otherwise it's very hard for you to stop or view the status of the downloads!)

•	Write *.log file for the downloaded file:  This option has GetRight write a separate log file for each file it downloads.  This file is the same name as the file downloaded, with .log added.  This file contains information about when it was downloaded, and from where it was downloaded, etc.

•	Keep a single log of all downloads:  You may enter a path and filename to have GetRight store some information as it starts and stops downloading files.  This log file will contain information about every file that is downloaded by GetRight.  Click the Browse button to select the path and filename using the standard "Save As..." window.

•	Maximum log file size XX KB:  This allows you to limit the size to which the log file will grow.  Whenever GetRight is started up, it will trim the log file so that it is this size.  A value of 0 means GetRight will not limit the file size.

(Main Configuration Help)


Configuring
Configuring GetRight

Starting the "GetRight - Configuration" window:

Windows 95 style user interface:

*     Right click on the GetRight [image] logo in your tray icons and pick "Configuration" from the menu that appears

OR

*     From the Start menu, then Programs, then GetRight, then "GetRight - Configuration".

Windows 3.x style user interface:

*     From the Program Manager, in the GetRight group, run "GetRight - Configuration".

You may also start this window from the "Configuration..." menu item in the GetRight Monitor menu   (see Accessing GetRight Monitor Menu for help getting this menu.)

GetRight allows configuring many options to suit the needs of many different users.  Most first-time users may accept the default values and will need to customize very few of the settings.  As you continue to use GetRight, you can configure other items to suit your needs.

The only settings that must be configured is if you use proxy servers , you must setup the Proxy server settings in GetRight.

Click the text below for help on the items on each specific tab:

[Monitor] [File Mirrors] [Login] [Save To] [When Done] [Advanced]

[General] [Proxy] [Connections] [Limits] [Internet]


Setup Alternate URLs

Normally, alternate URLs would be downloaded and automatically setup using a File Mirror List file or one of GetRight's other methods.  However, you may use this form to view or change the alternate URLs.

The top portion of the form contains a list of all the alternate URLs.

Alternate URLs added from any location (including here) may be discarded for a variety of reasons:

•	If the size of the file from the alternate address is different than the size of the file at the first address.   GetRight assumes the files are different and so discards the address (since continuing would corrupt the file.)

•	If GetRight is resuming the download and the address does not support resuming, it will be discarded.

Set:  sets the selected URL in the list as the next URL to be used when resuming a download.

Add:  lets you add a new alternate URL to the list.

Delete: removes an alternate URL from the list.


DefineCookies
Cookies:

Cookies are small bits of information that web sites can send to your web browser to store information for the next time you return to that site.  (Often used to save your user preferences for how the site should look/work.)


Proxy
A Proxy server acts as bridge between your computer and the Internet.  This tells GetRight that it needs to talk to the proxy server, and that proxy server will do all the communication to the Internet.


Thanks

Many people have helped make GetRight an even better program with suggestions, ideas for new features, testing, etc.  This list should contain many more names--but I haven't done a good job of keeping track...

Thanks to all of you (and to those who aren't listed here too.)

Rachel Burford (The Voice of GetRight)

Michele Catania

Fiddle Rydén

William Warner

Yuval Sadan (for some tray icon choices)

Ray Sormaz (for some tray icon choices)


About
About GetRight

 	GetRight Help Version 3.3.3

Copyright © 1997-99 HeadLight Software.

All Rights Reserved

 Contacting HeadLight Software

 Registering GetRight

Thanks...


Contacting
Contacting HeadLight Software

For the most up-to-date contact information, see:

http://www.getright.com/contact.html

Visit the HeadLight Software web site to find out about new versions of GetRight or other products from HeadLight Software at either of the addresses (these all go to the same place--www.getright.com is the easiest to remember or to tell other people:)

http://www.getright.com/

http://www.headlightsw.com/

http://www.headlightsoftware.com/

These will always have the most current versions of GetRight.

Many common questions and problems are addressed here or at http://www.getright.com/faq.html

Please check these to see if your question has already been answered before sending email requesting help (it's faster for you than waiting for an email response).

To contact HeadLight Software:

•	EMail:

HeadLight Software is adding more ways for you to get help faster.

Please see the contact information at http://www.getright.com/contact.html for the best and quickest way to get more help.

Help installing, setting up, or using GetRight:  help@headlightsw.com

You found a bug or have a suggestion:  bugs@headlightsw.com

You lost your registration code, and all other questions or mail:  mjb@headlightsw.com

(For lost codes, include the name and email address used to register to speed up getting help.)

•	Web:

http://www.getright.com/

http://www.headlightsw.com/

http://www.headlightsoftware.com/

•	Post:

HeadLight Software

PO Box 30473

Spokane, WA 99223  (USA)


Upgrade
Finding Upgrades to GetRight

The HeadLight Software, GetRight web site will always have the most current version of GetRight:

http://www.getright.com/

Or another address which goes to exactly the same place:

http://www.headlightsoftware.com/

In the MSWIN95 Forum on CompuServe; an official distribution and support online resource for future updates.

Search for GETRIGHT.


Online Registration

To register online with your credit card, go to:

https://www.setsystems.com/cgi-bin/buy-getright

or

https://www.qwerks.com/order/buynow.asp?ProductID=256

or

http://www.buydirect.com/Windows/Product/Detailed/0,3,1226,00.html?isv.hd

Or go to http://www.getright.com/buy.html for the latest purchasing options.

Your code will usually be emailed to you within minutes* of your order.

(Other Registration Options)


Mail Registration

Sending a check or money order payable to HeadLight Software along with the form below.

•	If ordering  1 to 10 copies     $17.50 US  per copy.

•	If ordering 11 or more copies   $12.50 US  per copy.

•	(If more than 50 copies, or for information about site licenses, contact HeadLight Software.)

Please enclose an additional $5 US per copy if you wish to receive a 3.5 inch floppy disk sent to you.  Otherwise you will receive a registration code via email.

(Print out and fill in the form below and enclose with your payment.)

(If you don't have a printer, it's fine if you just write the information on a piece of paper; and if a check in US dollars is a problem, I have gotten cash just fine from all over the world--but to be safe, be sure to wrap cash up tightly!)

================================================================================

                           GetRight Order Form.

Fill in the following information (please print or type--if your handwriting can't be read easily it can take longer to be sent your registration code!):

Name __________________________________________________________________

(Company--Optional) ______________________________________________________

Address ________________________________________________________________

City ___________________________ State/Province ____________ ZIP ____________

Country (if not USA) _________________________ Phone/Fax ____________________

E-Mail Address __________________________________________________________

(Make sure there is a valid email or mailing address so your registration code can be sent to you!)

Number of copies  __________ (Number with Disks (3.5 inch only) _______)

Price per copy                     ( 1 to 10 copies   = $17.50 US per copy.)

                                            (11 or more copies = $12.50 US per copy.)

                    x __________ (Add $5 to price per copy to receive difsks.)

Sub Total     = __________

Tax             + __________  (WA state residents ONLY add 8% tax)

Total           = __________

Mail to:

      HeadLight Software

      PO Box 30473

      Spokane, WA  99223  (USA)

Make sure your check or money order (in US Dollars) is enclosed and payable to HeadLight Software.

Your registration code will be emailed to you on receipt of your payment.

================================================================================


Phone Registration
Telephone Registration

To order by Telephone:

•	Please do not call these numbers for technical support questions--they are for ordering only.  For technical support questions, see contacting HeadLight Software or see http://www.getright.com/contact.html for all contact options.

•	(888) 201-7131 toll free within the US.  Have your credit card information ready.

•	(805) 284-2681 from outside the US.  Have your credit card information ready.

To order by FAX:

•	Please print the form at https://www.getright.com/faxform.html and fill it and sign it for FAX orders.

FAX the completed form to:  (805) 288-1867

Your order will be processed and your registration code will usually be emailed within 2 business days.

(Other Registration Options)


CodeDelivery
Most codes are sent and do arrive within minutes of your order being processed.  But there are some conditions which can make it take much longer than several minutes for the code to arrive.  Delivery be slowed down considerably by Internet or other network problems, mail server problems, or by far the most common: mis-typed or incorrect email addresses.

In these and other cases it might take much longer to get the code to you, if it has been more than a day, contact the company that processed your order for GetRight, or mjb@getright.com


Registering
Buying GetRight

This program is released as Shareware.

GetRight costs $17.50 (US)*  	($17.50 subject to change after March 31, 1999.)

You may use this program for 30 days free as a trial.  After that time you are expected to either register (buy) this program, or remove it from your computer.

What paying will get you:

•	A registration code which will remove all the annoying "Shareware Reminder" Windows.

•	Information on upgrades to GetRight.  (For the foreseeable future, and probably forever, all upgrades to GetRight will be free to registered users.)

•	A warm fuzzy feeling that you did the right thing.

•	Enable a few registered-only features (wildcards--* or ?--in FTP addresses, web page processor, more Login username/password entries.)

•	The more people who register this shareware, the more incentive to make GetRight even better.

Payment Options:

•	Online using your Credit Card.

(Usually, get your code emailed to you within minutes*.)

•	Telephone or Fax using your Credit Card.

(Usually, get your code emailed to you within 2 business days*.)

•	Mailing a check or money order.

(Get your code emailed to you after the letter arrives--but mail sometimes takes awhile.)

For the latest payment options, visit the HeadLight Software web site at:

http://www.headlightsw.com/

Entering your Registration Code:

Once you have received your registration code you must enter the number into GetRight to tell GetRight that you have registered.  You may enter the number by:

•	On all the "Shareware Reminder" windows, as well as the "About GetRight" window, click the "Enter Code" button and enter the number in the window that is displayed.  To get to the "About GetRight" window, you may Right click on the GetRight logo in your Windows tray icons and pick "About GetRight" from the menu that appears.

•	You may also enter the number at the bottom of the "General" tab on the GetRight configuration window.  To get to the GetRight configuration window, you may Right click on the GetRight logo in your Windows tray icons and pick "Configuration" from the menu that appears.

•	NOTE:  If the "Enter Code" buttons are disabled, it is probably because someone used one of the "pirated" registration codes that have been illegally posted on the Internet.  After you have legally registered (using one of the methods listed above) contact mjb@headlightsw.com -- include the name and email address you used to register to speed up getting help.

For the foreseeable future, all upgrades to GetRight will be free.

This $17.50 price is valid thru March 31, 1999 (and will probably increase to $20.00 when GetRight 4.0 is released.)

BUT if you register now, the upgrade to GetRight 4.0 will be free--so save yourself a few dollars and buy it now!


Shareware
Shareware:

Shareware programs are not free.  "Shareware" is the accepted word, but "Trialware" would be a better name for it.

You are usually given a period of time (30 days for GetRight) to use and evaluate the program to help you decide whether or not you wish to purchase the program.  After you are done with the trial period, you must either pay for the program (often called "registering") or remove it from your computer.

Please support the authors of good shareware programs (and their families) by paying this and other shareware programs!


Protocols Supported

GetRight supports both HTTP and FTP protocols.

Both these protocols support resuming requests, but not all the different servers you could download from will support resuming.  If GetRight is unable to resume, it will be indicated on the downloading form.  If the server does not support resuming, GetRight will automatically restart from the beginning when resuming connections.

Unfortunately, right now not all HTTP servers support resuming.  Many more FTP servers support resuming.

If the server does not support resuming, this will be indicated on the download window in case you wish to stop and start downloading from a different server.  (NOTE:  If you are using a proxy server and no servers are resuming for you, it is likely that your proxy server does not support resuming.  Try using some of the Proxy Server configuration options to get around this problem.)

To test if a server really will work before getting too far into a large file, wait until the file has been downloading for a few seconds, then click Pause, then Resume.  This will see if the file really can be resumed.


Glossary

A

B

C

D

Download - save a file from a server computer to your own PC.

E

F

FTP - File Transfer Protocol

G

H

HTTP - HyperText Transfer Protocol

I

J

K

L

M

N

O

P

Proxy - A Proxy server acts as bridge between your computer and the Internet.  GetRight (or any other Internet program) talks to the proxy server, and that proxy server will do all the communication to other servers on the Internet.

Q

R

S

T

U

URL - an address for a file on the Internet.  Usually looks something like http://www.headlightsw.com/index.html  The general format is PROTOCOL://SERVER.NAME/FILEPATH/FILENAME

V

W

Web Link (URL) - an address for a file on the Internet.  Usually looks something like http://www.headlightsw.com/index.html  The general format is PROTOCOL://SERVER.NAME/FILEPATH/FILENAME

X

Y

Z