Home
Blog
FAQ
Help
Feedback
mastodon
x
HyperDisk Icon

HyperDisk

User Manual

Released Feb 8, 2024

Revision 1

Updated Feb 8, 2024

Welcome to HyperDisk

HyperDisk is a Mac app for cleaning your hard drive. With HyperDisk you’ll be able to inspect and analyze the contents of your disk, and to confidently delete space-wasting files from your Mac.

HyperDisk suits two different types of users: those who want to do disk cleanup on their own, and those who prefer to let the app handle it for them. In this User Guide you’ll learn how to most effectively use HyperDisk to maintain a clean Mac.

Table of Contents

  1. Quick Start
  2. Installing and running
  3. Getting started
  4. Disk View
  5. Auto Clean
  6. Duplicate Files
  7. Similar Images
  8. Addenda

Quick Start

Fig.1 - HyperDisk’s intro window for first-time users
Fig.2 - HyperDisk’s main window

After downloading HyperDisk from the Mac App Store, launch it from your Applications folder (or, if you like, drag it onto your dock.) It’ll present you with its main window. If you haven’t launched HyperDisk before, you’ll see a window as shown in Fig. 1. If you’ve run HyperDisk before, you’ll see something like Fig. 2.

Select a folder to scan. We recommend starting with your home folder, as this is where most of the user-generated files will be on a Mac.

When in the main window, you’ll see four options (Fig. 2). They are:

  • Disk View, a 3D visualization of your hard disk and everything that’s taking up space.
  • Auto Clean, a smart scan that looks through your hard disk and identifies files that can be cleaned up.
  • Duplicate Files Scan, a feature that scans your disk for identical files, allowing you to delete redundant ones. (Running this scan does not automatically delete any files).
  • Similar Images Scan, a feature that scans your disk for similar-looking images, so you can keep only the best ones. (Running this scan does not automatically delete any files).

Fig.3 - The Disk View shows your files as rectangles

Let’s start with Disk View. Select Disk View, and click the Start Scan button at the bottom-right of the window (or hit Return).

HyperDisk will begin scanning all your files. When finished, you’ll be presented with HyperDisk’s 3D disk view. In this view, everything on your disk is represented as a rectangle. The sizes of these rectangles correspond to the amount of space they’re taking up on your drive. You can right-click on them for more information, or click and drag the background to tilt the view into 3D mode.

To explore HyperDisk’s other features, such as duplicate scan or auto cleaning, click on one of the options to the left of the window.

Closing HyperDisk’s window takes you back to the main window. Closing the main window quits the application.

Installing and Running

System Requirements

HyperDisk requires a Mac with Apple Silicon or an Intel CPU, running macOS 12.4 or higher. 8GB RAM is required, 16GB or higher is preferred. HyperDisk scans much faster on SSD drives than traditional spinning HDD drives.

Downloading

HyperDisk is available exclusively from the Mac App Store. For security reasons, it’s preferable to get your apps from the App Store when possible. App Store apps carry with them a greater assurance of safety, for two main reasons: 1) They have been reviewed by Apple for quality and safety, and 2) They are forced to run within a restrictive “sandbox” environment, making it difficult for them to damage your Mac.

After purchasing HyperDisk, download it from the App Store by clicking “Install”. As an App Store app, HyperDisk will auto-update when newer versions become available.

Running

Launch HyperDisk.app from the Applications folder by double-clicking it. If you’d like to put it on your dock, drag its icon onto your dock where you’ll be able to launch it with a single click.

Uninstalling

HyperDisk does not install extra files and helpers on your Mac. To uninstall HyperDisk, all you have to do is drag the application to the trash and empty it.

Getting Started

Overview

You’ll run HyperDisk by launching the application, choosing a folder or disk to scan, selecting a mode to use, and pressing Start.

Choosing a folder

HyperDisk operates on the contents of a specific folder you choose. Previously-scanned folders will show up in HyperDisk’s list the next time you run the app. You’ll probably want to scan your entire disk, or your home folder. Once you select the folder to scan you’ll be asked for permission. This is part of macOS’ security system, designed to prevent apps from operating in unauthorized parts of your disk.

Fig.4 - HyperDisk may make a series
of authorization requests like this one.

At times, you’ll be prompted with a series of authorization requests. You’ll be asked to allow access to things like your Photo Library and your Desktop folder. Please allow all these requests, as HyperDisk is not able to scan and analyze folders to which it’s not authorized.

These security measures are built into macOS, and they help to keep your computer safe.

Shortcuts

  • General
  • ⌘1  Disk View
  • ⌘2  Auto Clean
  • ⌘3  Duplicate Files
  • Disk View
  • arrow keys  Rotate view
  • ⇧⌘2  Re-center view (2D)
  • ⌘-  Decrease maximum depth
  • ⌘= Increase maximum depth
  • ⇧⌘[  Previous color scheme
  • ⇧⌘]  Next color scheme

Disk View

Scanning your disk

No matter which mode you choose (Disk View, Auto Clean, etc.,) HyperDisk will start by scanning your file tree. Since HyperDisk delves into all the folders and subfolders, this can be a time consuming process. A status window will appear if the scan is taking more than a few seconds. You’ll see a meter showing the rate at which HyperDisk is scanning your files. The meter is coded with HDD (Hard Disk Drive,) SSD (Solid State Drive,) and NVMe (Non-Volatile Memory express,) corresponding roughly with the speeds you can expect from each class of storage device.

Fig.5 - HyperDisk shows your files as rectangles, sized
according to their file size on disk.

2D disk view

When the scan completes, you’ll see a big rectangle comprised of smaller rectangles. These represent folders and files on your Mac. Files within the same folder are next to each other, and colored with the same hue.

You can hover your mouse over this view to see some information and a preview (if available) of the files. Clicking on a rectangle will bring up a menu with some options specific to the file.

The 2D disk view is in effect just a straight top-down view onto the 3D disk view. Hovering your mouse over a rectangle shows some information about it in the panel to the right.

Fig.6 - Tilt the view into 3D mode to visualize files
atop the folders that contain them.

3D disk view

You can tilt and rotate the 2D disk view into 3D mode either by clicking and dragging on the view background, or by using the arrow keys.

In 3D mode, the top-level folders of the scan are shown as larger rectangles at the bottom. These folders’ contents are then drawn as smaller rectangles above, and so on. A finite number of levels will be drawn, and this number can be changed via the stepper control at the top, or with ⌘- and ⌘=.

Hovering your mouse over a rectangle shows some information about it in the panel to the right.

Fig.7 - Clicking on a file in Disk View brings up
a menu of options.

Revealing and deleting files

Clicking on a rectangle in the disk view will bring up a menu of actions.

  • Lock focus on this layer
    Make it so the 3D disk view highlights a specific layer of depth. This makes the mouse interact only with rectangles which are at the same level of depth as the selected file or folder. To undo this locking, click on the background.
  • Reveal in Finder
    Open the folder that contains the highlighted file and show it in the Finder.
  • Zoom in
    Zoom into the disk view, so that the selected item’s enclosing folder becomes the base layer of the view. Undo this using the path display at the top of the window.
  • Move to Trash
    Move the selected file or folder into the Trash. The file is not deleted until you empty the Trash via the Finder.

Tips

To quickly find out what’s taking up large amounts of space on your disk, try finding big rectangles or big clumps of rectangles and moving your mouse over them. As you do this, look at the file’s path in the top-right of the window. This will give you an idea of where the file comes from, and what it’s doing.

Be careful with what you delete. When in doubt, hang on to the file. The safest thing to do is to back up any files you’re uncertain about before you delete them.

Auto Clean

Fig.8 - The main window for Auto Clean.

Scanning your disk

See Disk View

Setting the depth of clean

You can control how aggressively HyperDisk cleans your drive by moving the large slider between light clean and deep clean. As you do this, the amount of space to be freed up will update inside the green capsule above the slider. A specific list of files to be deleted or linked together is shown at the right.

It is recommended to start with a fairly light clean, as long as a significant amount of space is freed up by such. Light clean will only delete files which are almost certainly unnecessary, such as old cache files. As you increase the depth of the clean HyperDisk deletes more aggressively, removing things like certain duplicate files and applications which haven't been used in a long time.

Alerts

HyperDisk may show some alerts in Auto-Clean.

  • HyperDisk can clean more thoroughly if you can your entire hard disk or home folder.
    If you’ve only scanned a folder on your disk as opposed to your entire drive, then HyperDisk will not be able to free up much space with Auto Clean. You can remove this warning by closing the window and scanning your entire drive.
  • HyperDisk can do additional cleanup if you scan for duplicate files.
    At deeper levels of clean, HyperDisk begins trying to link together large duplicate files (see Hard links below.) In order to do this, you must scan for duplicate files. You can do this by clicking the "Scan duplicate files" button.

Hard links

Hard links are effectively multiple files which all reference the same underlying content. You can have a number of hard links of a particular file, and they will occupy only the space of a single copy of that file on your disk. HyperDisk has the ability to find large identical files, and hard link them together to free up space.

In depth:
To really understand how hard links work, some background on filesystems is helpful. On modern computers, files are stored on the disk as something called an inode, as in “index node.” These are the raw on-disk files, containing the real data that the file holds. The files that show up on your computer as documents, images, videos etc, are all references to a particular inode.

By creating two or more files which both refer to the same inode, we have created what’s known as a hard link. HyperDisk can identify duplicate files, and if they’re all referring to different inodes, it can delete all but one of those inodes and make hard linked files that all point to the same inode. For example, four identical 1GB files could be merged so that they appear the same, but take only 1GB of total space.

Fig.9 - The Final Review screen for Auto Clean.

Safety considerations

Auto Clean is a feature to be used with caution. Unless you’re doing a very light clean (10% or less on the slider,) it’s very important to review the files that will be deleted. You can click “Proceed to Final Review…” without committing to anything. The following confirmation screen is the one where you look through the proposed deletions, and approve or deny them.

Final review

After clicking “Proceed to Final Review…” at the bottom-right, you’ll have one last chance to review all the deltions HyperDisk is about to make, and to approve or deny them. When you select one, a summary of the action is shown at the right, along with a brief rationale of why HyperDisk wants to delete that file. You can disable any of the proposed actions either by flipping the “Enable” switch, or by checking the box in the “Enabled” column of the table view.

Clicking Clean on this view is a final action, which will actually delete the marked files from your disk.

Duplicate Files

Fig.10 - The results view for Duplicate Files scan.

Scanning for duplicates

HyperDisk’s duplicate file scan will look through all the files in the folder you scanned, and find any identical copies. Files are only considered identical if their raw content is byte-for-byte identical to one another.

Results browser

After the duplicate files scan has finished, results will be shown in a table. By default, files with the greatest number of duplicate copies are shown at the top. This sorting order can be changed via the “Sort by” popup. Also by default, locked files are not shown. (“Locked” is a flag that can be set on files in the Finder’s Get Info panel. It is an advisory flag that indicates that the file should not be deleted or modified.)

Marking files for deletion

Fig.11 - Duplicate files appear as a stack, and can
be individually marked for deletion.

To mark files for deletion, click the ⓧ symbol next to the file that you want to delete in the bottom-right table. This will not immediately delete the file—you’ll have a chance to review your choices later.

You can also use one of the shortcut buttons, such as “Delete all but one.” This option keeps the file with the shortest path (i.e. the least deeply-nested file,) and marks other copies of it for deletion.

Hard linking files

In the arrow menu to the right of “Delete all but one,” there is an option to hard link the files. This merges all the duplicate files into a single on-disk file with multiple instances, or hard links. The process of hard linking is described in more detail above, in the Hard links section.

Final review

When you’re ready to delete the marked duplicate files, you can click on the “Perform cleanup…” button. This will present one final confirmation dialog with three buttons.

  • Move to Trash
    The marked files will be moved to the Trash. They won’t be deleted until you Empty Trash in the Finder.
  • Delete files
    The files will be deleted immediately.
  • Cancel
    Close the dialog, and don’t make any changes.

Similar Images

Scanning for similar images

The Similar Images scan performs a deep analysis on all the image files on your disk. It compares photos for similar appearance. With this scan, images that look alike will be grouped together.

The Similar Images scan is useful for finding images that were taken of the same subject in rapid succession, or an image that was saved in different sizes or file formats.

Results browser

The interface for this tool is the same as the Duplicate Files tool.

Marking files for deletion

The interface for this tool is the same as the Duplicate Files tool.

Final review

The interface for this tool is the same as the Duplicate Files tool.

Addenda

A note about disk space

Apple’s current APFS filesystem introduced a number of broad changes from the legacy filesystem, HFS. In APFS, free space does not always update immediately. Often after deleting some large files, the disk will still claim to have the same amount of free space as before the deletion. This is normal, and sometimes it takes a while to update.