Dockhunt CLI

Website ⋅ Twitter ⋅ npm

Scans which apps you have in your macOS dock and shares the result with Dockhunt.

Usage

npx dockhunt

What does it do?

1. Scans your macOS dock
   • For each app, find its name and the path to its icon file
     • Using defaults export com.apple.dock - (see defaults help)
   • Converts each icon file from .icns to .png
   • Uploads the app names and PNGs to the Dockhunt server
2. Opens the Dockhunt website in your browser
   • You'll be invited to authenticate with Twitter to add your dock to the site
   • You can share your dock and see who else has the same apps in their dock

Incorrect app icons

If you notice that the app icon that for an app is incorrect, it means the CLI tool picked the wrong icon file. We can resolve this if you open a GitHub issue with the name(s) of the app(s) that have incorrect icons and their corresponding .icns file(s). You can find the .icns file by right-clicking on the app from the Finder and selecting Show Package Contents. Then, navigate to Contents/Resources/ and find the .icns file. If it's not in Contents/Resources/, then it may be somewhere else in the package contents.

Here's how that looks like for Figma:

Development

• It is only necessary to build the app if you want to package it into an executable. The building of the app will package all the dependencies into a single file, which can then be packaged into an executable using pkg. Currently, the dockhunt executable isn't being used as it was intended for non-technical users, but prooved to complicated to user. The npx command is used instead.