Download

To download is to copy a file from a web server to your local computer. Reliable downloading takes skill in the face of occasional technical challenges.

Back on the page that referred you here, you should have a download link that you are interested in. The following instructions relate to that page. Place the pages side by side.

How to Download

Using Firefox

• right-click on the link, and a menu will appear,
• click on Save Link As..., and a dialog window will appear asking you where to put the file,
• tell it where you want the file put, and then a Downloads window will appear,
• wait for the download to complete,
• close the Downloads window,

The file will be in your Downloads directory.

Using Firefox on Mac OS X

Some Mac OS X systems lack a right-click button. Use control-click instead of right-click, then follow the generic Firefox instructions above.

Using Safari

• control-click on the link, select Download Linked File As ..., and a Save As dialog will appear,
• click on Save, the dialog will go away,
• a Downloads window will appear,
• wait for the download to complete,
• close the Downloads window.

The file will be in your Downloads directory.

Using Internet Explorer

• right-click on the link, select Download.

(to be completed by someone who knows how it works)

Using curl

curl is a download program that is very simple, very reliable, and can restart a partial download.

curl is available on Mac OS X by default, and can be installed on Linux or Microsoft Windows.

• right-click on the link in your web browser, and select Copy Link Location (Firefox), or control-click on the link and select Copy Link (Safari),
• start a Terminal, and then type

cd Downloads

• then type

curl -OC -

• press the space bar once more, to add a gap after the dash,
• paste the link, so that the command looks like this:

curl -OC - http://something/

• press enter, and the download will begin,
• wait for the download to complete,
• close the terminal.

To interrupt a download and resume it later, press Control/C. When you wish to resume, press up arrow once to recall the command, and then press enter to start it again. The download will resume from where you interrupted it.

Using wget

Start a Terminal, then type

wget --continue ${URL}

Where ${URL} is the link.

To interrupt a download and resume it later, press Control/C. When you wish to resume, press up arrow once to recall the command, and then press enter to start it again. The download will resume from where you interrupted it.

If the available space is too small, download directly to a USB drive; first insert the drive, then change directory to it, then use wget, like so:

cd /media/USB_DISK
wget --continue ${URL}

Using Browse

Browse is not recommended for large downloads, because:

• the file name gets changed, requiring extra steps,
• the available space may be too small, requiring extra steps,
• some versions of Sugar may fail when copying very large files to USB drive, and;
• extra stress on the endurance limit of the internal storage.

However, if you wish to risk it:

• click on a download link to start, and a download progress will be shown,
• wait for the download to finish,
• copy the file to a USB drive by dragging the Journal entry to the USB drive icon.

Verifying

For some downloads, the directory also contains an md5 file that can be used to check that your copy of the file is intact. If you have downloaded both filename and filename.md5, execute this command in the directory to which they were downloaded to check the integrity of filename.

md5sum -c filename.md5

Problems

Displayed instead of Downloaded

If you use the normal click, some web servers cause your web browser to display the file instead of download it.

You must bypass this using one of the methods above.

Takes Too Long

A download that takes too long is usually caused by:

• your internet service is too slow,
• your internet service is being shared with other people,
• the file is far too large.

You should either keep waiting, or use one of the interrupt and resume methods above.

Running out of space

Running out of space will cause a download to be interrupted.

You must make more space available, by either deleting things, or by adding external storage.

Then you should either try the download again, or try to resume it using one of the methods above, such as wget or curl.

Interrupted

A faulty or irregular internet service may cause a download to be interrupted.

You should either try the download again, or try to resume it using one of the methods above, such as wget or curl.

Downloaded File is a Document

We use several unusual file types that are not known by your computer. This may cause your computer to use an icon for the file that represents a document. We can't fix this. This can be ignored. Proceed to use the file as instructed.

In Mac OS X for example, a .zd file is shown in Finder as a document. An .img file does not, since .img is a file type that is used for disk images.

Other operating systems may indicate that the file is a document.

Downloaded File has Wrong Name

Some methods of downloading may change the file name.

In particular, using Browse and the Journal will add .bin to the end of the file name. You must fix that by renaming the file. In GNOME right-click on the file and rename. Or in Terminal:

cd /media
cd 'USB DISK'
mv filename.zd4.bin filename.zd4