GrandPerspective icon

Refresh and rescan

Refresh and Rescan can both be used to create an up-to-date view of previously scanned contents.

Refresh only rescans folders that are changed, based on file system events generated by macOS. Rescan scans the contents of all folders again. Refresh is therefore faster and recommended by default.

A difference between rescan and refresh is the behaviour of filters applied to packages. When rescanning, filters treat packages based on the current package content display settings. When refreshing and a filter is already active, it uses the mode that was originally used. This ensures that the filter is consistently applied and the difference with the original view is only due to changes in file system contents.

In rare cases the contents of a refreshed view can be inaccurate. This can happen when changes occur in folders that contain hard-linked files. In that case, hard-linked files may appear more than once or may be erroneously omitted from the resulting view. This respectively over-estimates or under-estimates the storage space that the scanned folder consumes. When this may be the case, a warning panel will be shown suggesting that you perform a Rescan instead.

Refresh is only available for views that are scanned in the current session. On a view created by loading previously saved scan data, only rescan is available. One reason for this is that the contents may be from a different machine. Another reason is that the delta may be too big for the refresh to be fast and accurate.