IncludePlot (2) 

Show real-time bandwidth use for the download by setting "IncludePlot"→True:

In[12]:=

Use a more light-weight progress panel by disabling the bandwidth plot:

In[13]:=

ExpectedFileHash (2) 

If the MD5 hash of the remote file is known, MonitoredDownload can automatically verify the integrity of the download when completed:

In[14]:=

In[15]:=

Out[15]=

An incorrect file hash will lead to a warning:

In[16]:=

DeleteOnHashFailure (2) 

Automatically delete the downloaded file if it fails to match a given expected file hash:

In[17]:=

Verify that the file has been cleaned up:

In[18]:=

Out[18]=

CookieFunction (1) 

Apply a function when cookies are set:

In[19]:=

In[20]:=

Out[20]=

OverwriteTarget (2) 

By default, the one-argument form of MonitoredDownload attempts to automatically name the destination file so as not to conflict with existing files:

In[21]:=

In[22]:=

Out[22]=

Overwrite any existing file instead:

In[23]:=

Out[23]=

Using the second argument of MonitoredDownload overrides any settings for OverwriteTarget:

In[24]:=

In[25]:=

Out[25]=

In[26]:=

Out[26]=

The file has been overwritten:

In[27]:=

Out[27]=

KeepPanelOpen (4) 

By default, the progress panel is automatically removed when the download completes:

In[28]:=

Out[28]=

Keep the panel open instead:

In[29]:=

Out[29]=

When using "KeepPanelOpen"→True, the panel will persist in its current state even if the Cancel button is pressed:

In[30]:=

Once canceled, the panel becomes static with no dynamic content:

In[31]:=

In[32]:=

Out[32]=

Compare to the cell prior to an abort:

In[33]:=

Out[33]=

In[34]:=

Out[34]=

ShowPanel (1) 

Use "ShowPanel"→False if you don’t want to display any progress panel:

In[35]:=

Out[35]=

Asynchronous (3) 

By default, files are downloaded asynchronously, so the output of MonitoredDownload returns quickly:

In[36]:=

Out[36]=

Use Asynchronous→False to wait for the download to finish before returning a value:

In[37]:=

Out[37]=

Downloading synchronously allows you to use the resulting file without needing to check if the download has completed:

In[38]:=

Out[38]=

FinishedDownloadHandler (2) 

Apply a function to the downloaded file once the download completes:

In[39]:=

Out[39]=

Download a notebook asynchronously and open it when ready:

In[40]:=

Out[40]=

OpenWhenFinished (2) 

During a download, the "Open When Finished" checkbox can be used to automatically evaluate SystemOpen on the completed file when ready:

In[41]:=

Alternatively, this setting can be made programmatically using the "OpenWhenFinished" option:

In[42]:=

Automatic File Naming (6) 

When only using the one-argument form, MonitoredDownload attempts to automatically choose sensible filenames based on the MIMEType:

In[48]:=

Out[48]=

In[49]:=

Out[49]=

Automatically named files will be placed in the current directory:

In[50]:=

Out[50]=

In[51]:=

Out[51]=

Changing the current directory with SetDirectory will also change where the file is saved:

In[52]:=

Out[52]=

In[53]:=

Out[53]=

In[54]:=

Out[54]=

For cloud objects, the file name can be determined even if it’s in UUID form:

In[55]:=

Out[55]=

In[56]:=

Out[56]=

When file names are determined automatically, numbering will be used to avoid conflicts:

In[57]:=

Out[57]=

In[58]:=

Out[58]=

In[59]:=

Out[59]=

Using OverwriteTarget→True will use the base chosen filename (without numbering), and overwrite the existing file if necessary:

In[60]:=

Out[60]=