Frequently Asked Questions

If you're having trouble using SiteSucker, look below for a solution.

Why doesn't anything happen when I try to download a site?

There could be a number of reasons why SiteSucker fails to download a site. First, check the log file for any errors. If there are no errors, turn on the Log Warnings option under the Log settings and try to download the site again. The errors or warnings will probably explain why the download failed.

If the errors or warnings don't reveal the problem, you might want to try changing the Identity setting. Some sites are particular about which browsers they will allow. SiteSucker has an Identity setting that allows you to "fool" the site into thinking that you're using an approved browser. To change SiteSucker's identity, select one of the web browsers listed in the Identity control in the Request settings.

Why doesn't SiteSucker remember my changes to the settings?

After making a change to the settings (such as changing the destination folder), you need to choose Save As User Defaults under the Settings menu to save those settings as the new user defaults. The user default settings are assigned to any new SiteSucker documents.

Can I change the number of simultaneous connections?

The Preferences window lets you set the number of simultaneous Internet connections for new SiteSucker windows.

How can I browse a site offline?

Here is the preferred way to download a site so that you can view it locally.

Under the General settings, set the File Modification option to Localize. With this setting, SiteSucker modifies the downloaded HTML documents by replacing every link to a file on a web server with the corresponding link to the local file. This provides the best results when browsing files offline.

After SiteSucker has downloaded your site, click the File button in the SiteSucker toolbar to display the downloaded site in your default web browser (Safari, for example).

Why won't SiteSucker download rollover images?

Rollover images are images that appear when your mouse moves over a link on a webpage. SiteSucker doesn't download rollover images because they are displayed using JavaScript. SiteSucker is a relatively simple program and it totally ignores JavaScript.

Can I download images without downloading HTML files?

Even though you may only want to download images, SiteSucker still needs to download HTML files since it needs the hypertext links in order to find all the images.

However, you can have SiteSucker delete HTML files after they are downloaded and analyzed by selecting the Delete After Analysis setting in the File Modification pop-up under the General settings.

Can I use SiteSucker with a web proxy?

If your computer is protected from the Internet by a firewall, you may need to use a web proxy to access websites. The web proxy is set up in the Network preferences. (See Mac Help for more information.) If a web proxy has been configured, SiteSucker will automatically direct your requests to the specified proxy server.

Can I have SiteSucker download a site periodically?

The best way to schedule site downloads is by using the Calendar app. Assuming that you're running macOS 10.11 El Capitan and the latest version of SiteSucker, you create a Calendar Alarm as follows:

  1. In SiteSucker, save a document with the desired URL and settings.
  2. In Automator, create a Calendar Alarm.
  3. Select Internet from the library pane.
  4. Select and drag the Download Sites action into the workflow area.
  5. Select Other in the SiteSucker Document pop up and then choose the document from step 1.
  6. Save the newly created Calendar Alarm.

As soon as the workflow is saved, Calendar is opened and the new event is automatically created. Just adjust the date and time and set the repeat interval for the event.

You can set up a SiteSucker document and Calendar Alarm for each site that you want to download periodically.

How do I download YouTube and Vimeo videos?

In general, YouTube and Vimeo videos are found on servers external to the site being downloaded. For this reason, you should turn on the Include Supporting Files option under the Webpage settings. This will force SiteSucker to include supporting files, such as videos, in the download. You may also need to turn on the Ignore Robot Exclusions option under the General settings before videos will download.

Why are links not responding or subtitles not appearing in videos?

The operating system adds the com.apple.quarantine extended attribute to all files that SiteSucker creates. To guard against malware, quarantined executables cannot be opened or executed without user confirmation. But this attribute also prevents subtitles files from working with HTML5 videos and prohibits JavaScript from performing HTTP requests, disabling links in some downloaded webpages. The only way to fix this problem is to remove the attribute manually. You can use the following command in the Terminal application to remove the com.apple.quarantine extended attribute from all files in the destination folder:

xattr -r -d com.apple.quarantine path_to_destination_folder

For the default destination folder, you can use the following command:

xattr -r -d com.apple.quarantine ~/Downloads/us.sitesucker.mac.sitesucker

How do I download a site created with Squarespace?

In general, to download Squarespace sites, choose Factory Defaults in the Settings menu, then turn on the Include Supporting Files and Download Using Web Views options in the Webpage settings. To reduce clutter in the Downloads folder, I recommend turning on Delete robots.txt in the SiteSucker preferences. Enabling the Ignore Robot Exclusions option in the General settings my be required to download all content from some sites. Finally, to get some of the site's images, you may need to add the custom data attributes data-image and data-src to the Attributes table in the Webpage settings so that SiteSucker knows to scan these attributes for URLs.