General Preferences Tab

You can control the following behavior of Hook on the General tab:

Hook 3.7: General-Preferences screenshot

1. “Hooked” indicator in menu bar icon

If Show current item's number of hooks in menu bar icon then Hook’s menu bar icon will change dynamically to reflect whether the currently open or selected item is hooked to anything. It will do this regardless of whether Hook’s contextual window is open.

This means you don’t need to open the Hook window to see whether an item is hooked to something.

See Menu bar icon badge showing number of links to the current item for more information.

2. The effect of clicking Hook’s menu bar icon

You can configure whether clicking Hook’s menu bar icon shows:

Regardless of this setting, if you hold the option key down while clicking Hook’s menu bar icon, the menu bar window will appear.

3. Hook Context Window (appearance and hiding)

You can configure several aspects of the Hook (contextual) Window itself.

3.1 Hide Hook context window after copying links (checkbox)

If this is checked, then after you use the Copy Link, Copy Markdown Link, and Hook to Copied Link), the Hook will remain present. By default, this setting is unchecked.

Advanced users will prefer to disable this setting.

Even if this is disabled, Hook will automatically disappear if you open an item through Hook or use the ESC key — as macOS Spotlight® and launchers like Alfred and LaunchBar do.

Advanced users will normally check this (auto-hiding).

NB, prior to Hook 3.7, this was called Automatically hide Hook context window and would default to check.

3.2 Toolbar buttons

You can configure whether Hook shows any or all of the following buttons in its toolbar:

3.3 Sections

You can configure whether Hook shows the following sections:

  • Pinned items
  • Recent items

You can also control how many recent items are shown.

4. Links: hook://file/ URL-handling, notifications, and export/import

You can configure the following three aspects of Hook’s linking:

4.1. Reveal hook://file link targets in Finder

When you use Copy Link on a file, Hook creates a link containing a hook://file URL. You can paste that hook://file// URL anywhere. Similarly, invoking Make Hook File on a selection in the Finder creates a .hook file that contains a hook://file// URL.

The Reveal hook://file link targets in Finder determines what happens when you click on such hook://file// links. The choices are:

  • to reveal the target of the link (the file) in Finder, or
  • open them

NB: this preference does not affect what happens when you

  1. access files via Hook’s contextual window. If you double-click ( or return key on) a hooked file, Recent item, Pinned item, or Search, Hook will necessarily open that file regardless of this setting.
  2. open .hook files that contain a link to another type of resource than files, such as web pages. That is because .hook files can contain any link. And of course, you can’t reveal remote web pages in Finder 🙂 .

4.2 Playing menu bar icon linking sounds

This checkbox controls whether sounds are played when you create links with Hook

By default, Hook issues notifications macOS notifications when you create links. You can disable and configure Notifications in the macOS Apple menu > System Preferences > Notification pane. See Apple’s documentation on notifications.

4.3. Export and Import of link data (Advanced feature)

Hook’s General Preferences tab contains an Export and an Import button. These buttons are provided as one of several alternative means of backing up and restoring Hook links. For more information see this web page. See also instructions on migrating Hook between Macs.

In the unlikely event that Hook data become corrupted, you can import previously exported links. This process may detect and remove inconsistent data. You can also use the export/import buttons to compact the Hook link database. When you export Hook links, Hook does not include links to files that are not currently mounted / reachable. This effectively purges links to files that have been deleted or on media that you no longer use. However, this leads to the following caution.

  1. You need to ensure that all mobile /removable directories, to which you have links that you wish to preserve, are connected at the time of both exporting and importing. That includes version control system folders, shared folders (Dropbox folders, etc.), and removable media (external drives, disk images, etc.). Hook will drop the disconnected info. This is a way of paring down Hook’s database to exclude files that are no longer reachable.
  2. Please also ensure that Spotlight is indexing the folder contained by files to which hook://file/ links point.

5. Hook Folder: where it is stored

At the bottom of Hook’s General Preferences tab, you can choose where Hook creates its (Hook) folder. By default, Hook creates it in ~/Documents.

The Hook folder contains a

Please note that this command will not move your prior Hook folder’s contents; it simply chooses a new folder.

Restart Hook in order for changes to the Hook Folder setting to take full effect.