No Linkable Item in …
When you invoke the Hook window, it needs to identify the current item (document or object). If Hook cannot identify it, the status bar message will say
No linkable item found in
<App>. Learn more
<App> is the name of the app. For example, “No linkable item found in Preview.”
There are several possible causes and solutions for this situation. First, let’s consider a general work-around.
0. General work-around: Use the app’s UI, if any, and Hook’s
Focus on Link in Clipboard
You can work around any
No linkable item found in <App> message shown in any app that has a
Copy Link function, even if it lacks proper automation for linking.
Simply copy a link using the app’s user interface, and then use Hook’s
Focus on Link in Clipboard (⌃⌘L). That puts the link in the title bar. If the link’s name is not helpful, you can easily rename it with Hook’s
Rename in Hook Title bar command (aka ⌃⇧). See also 💡Rename Links to Suit Your Needs – Hook
1. You have not granted accessibility permission to Hook
This allows Hook to interact with macOS and its apps.
1.1 Your accessibility permission database is corrupted
macOS accessibility permissions database can get confused. In that case you might see strange behavior like not being able to disable or enable permissions for an app. In that case, you may reset Accessibility for Hook as follows:
tccutil reset Accessibility com.cogsciapps.hook
- reboot your Mac.
2. Hook’s Automation permission to control the app is effectively disabled
In addition to general “accessibility”, Hook also needs automation permission for any app that you want it to control.
So, perhaps you have not granted Hook Automation permission to control that particular app. Or, due to an apparent bug in macOS, macOS may have ‘forgotten’, or failed to record, that you granted Hook permission to control a particular app. Or you may have revoked such permission.
You can grant, or re-grant, permissions as follows:
- From the Apple menu, open System Preferences
- Click on the Security & Privacy button
- Click on the Privacy tab
- click on the Automation tab
- if an app is not enabled, enable it.
- if the problematic app is enabled, try unchecking it, then checking the checkbox again.
- You will need to relaunch the app, and perhaps even restart your Mac.
In rare cases: Even if your app is listed macOS due to an apparent Bug in macOS (particularly Big Sur), you may need to uncheck the app (remove the checkmark), re-check the app, and restart your Mac.
3. The foreground item has not been saved
It is impossible to link to (or from) a item until it is saved. Some applications (e.g. Notes.app, Bear, nvALT) save new items as soon as they’re created, but many applications (e.g. TextEdit, BBEdit, Photoshop) let you open a new window and start writing or modifying new items which don’t exist in the file system and cannot be hooked until they are saved.
Tip: Save new items before invoking Hook on them.
4. The email has not been sent
You cannot (normally) link to or from an unsent email. That’s because the ID of an email is assigned after it is sent. Hook normally identifies emails by their standard “Message-ID” , per Section 3.6.4 of RFC 2822. Until an email message is sent, the message does not have an ID. Therefore an unsent email cannot be referenced.
5. No item is selected, open or loaded in the frontmost window
In the following conditions, there is no item for Hook to get information about.
- there is no open window
- the frontmost window has no object, or
- no item has been selected in a window that lists a bunch of items,
So, you’ll get
No linkable item found in <App>. You can still use Hook’s search in that case.
- If you are in an app but have not opened an item, then there is no item for Hook to get information about.
- If you have accessed a web page that has not yet loaded, it is not possible for apps (including Hook) to tell what the address or name of the web page is.
Tip: Ensure that the correct window is frontmost, and that the desired item is open or selected.
5.1 A palette is open or has the focus
Some apps have palettes. When Hook is invoked in the context of a window but a palette window is open, Hook might show the “No linkable item found in” message. That is because when Hook communicates with the app to get information about the frontmost window, the app returns information related to the palette, or no information at all.
6. UI scripted app and macOS or app language is not yet supported
In this case Hook’s internal scripts need to be in the same language as the app is currently configured. Hook supports English, and partially supports other languages. This page lists languages. If your language is not yet supported, you can our tech contact support, preferably providing the equivalent to
Copy Link for that app. Compare this Firefox issue.
Ulysses Mac app is an example of an app with no automation. Hook has a contorted way of controlling this app. However, we recommend using its alternatives, like Craft which do have adequate automation. That will also give you many advantages apart from Hook.
7. The app is unsupported
Some apps have no adequate facility for linking. In that case your best options are:
- Contact the app’s developer using these tips.. MANY developers have added support for linking. For a competent developer, this can take less than a day. If the developer seems insecure about programming, you can point them to the x-callback-url website — plenty of examples of Mac developers who have added automation to their apps. (Or they can check out Hook’s apps page.
- Switch to a competitor that understands the value of linking and automation.
Keep in mind: if an app you are using has no automation, then sooner or later you might pay the price of vendor lockin. It’s best to use apps that provide automation for getting data out of them.
8. You’ve problematically overridden Hook’s integration script for this app
For Pro users, it is possible inadvertently to modify the integration script for an app in a way that breaks the integration between Hook and the app. If you don’t know what this means, then you most likely have not done this. But if you have, then your best bet may be to remove your custom integration, as follows.
- On the left side of the Scripts Panel of Hook’s Preferences window select the app bundle in question.
- click the
-(minus) button on the bottom left.
That will enable Hook to use Hook’s integration script for the app (which depending on the could be the default script). See Creating and Modifying Integration Scripts for more information.
You might need to do a Hook software update to get the latest integration software from CogSci Apps Corp.
9. System Integrity Protection (SIP) is disabled
As mentioned on Hook’s “buy” page, Hook requires that System Integrity Protection to be enabled on your Mac. SIP-enabled is the default of macOS; it requires root privileges to disable. It is generally not recommended to disable SIP. Compare:
System Integrity Protection on your Mac (Apple Support).
Workarounds: Copy the Link manually, etc.
As long as an app has a
Copy Link function, you can use it with Hook.
- Just use the app’s
- go to another item in another app
- invoke Hook and choose
Hook to Copied Link
You can also use Hook’s other functions , such as searching its bookmarks.
Ongoing and future developments
CogSci Apps, with the help of its savvy forum members supports a growing number of linkable apps.