CleanShot X Workflow

[Mr Pennyworth]

CleanShot X Workflow: Download

 

Requiremens

• Alfred 4
• CleanShot X (version 3.5.1 or above)
  

Screenshots

Credits

This workflow is based on, and a slight improvement of, Raycast’s CleanShot X script commands.

 

Icon Credits

Some icons from by srip and freepik from flaticon.

[Chris Messina]

Ha! I made a much more basic version of this but never released it... nice job! 

 

[Mr Pennyworth]

3 hours ago, Chris Messina said:

Ha! I made a much more basic version of this but never released it... nice job! 

Thanks @Chris Messina!

Damn, you should've released it!!

 

I have a couple of questions:

1. Did you also find out about the cleanshot:// urls from Raycast? If not, please do tell how you went about it, it might come handy for other apps!
2. Did you extract those icons from CleanShot's assets.car? If not, again, please do tell! (I have zero design chops or any related abilities, so it might come handy to me later on)

 

[poirpom]

@Mr Pennyworth Awesome workflow. Thank you very much for sharing it. 🙏

[vitor]

@Mr Pennyworth To find URL schemes supported by an app, reading the ${app_path}/Contents/Info.plist file and looking for CFBundleURLSchemes tag if often enough. Or doing /usr/libexec/PlistBuddy -c 'print :CFBundleURLTypes' "${app_path}/Contents/Info.plist".

But I think you’ll like this more: /System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister -dump URLSchemeBinding. It shows every available URL scheme (on your machine).

As to how to use them, that’s the job of the developer’s documentation.

[Mr Pennyworth]

2 hours ago, vitor said:

But I think you’ll like this more: /System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister -dump URLSchemeBinding. It shows every available URL scheme (on your machine).

This is amazing!!! 🎉

 

2 hours ago, vitor said:

As to how to use them, that’s the job of the developer’s documentation.

Unfortunately CleanShot X doesn't have any

I had to go digging into the package bundle and had to resort to strings and got lucky at some places

strings /Applications/CleanShot\ X.app/Contents/PlugIns/AnnotateShareExtension.appex/Contents/MacOS/AnnotateShareExtension | grep cleanshot

# printed: cleanshot://share-extension-annotate?filepath=

strings /Applications/CleanShot\ X.app/Contents/PlugIns/PinShareExtension.appex/Contents/MacOS/PinShareExtension | grep cleanshot

# printed: cleanshot://share-extension-pin?filepath=

 

[paulminors]

Great workflow, thanks for sharing.

 

When I tested it out, I'm able to start new recordings etc. However, when I try to annotate or pin an image, I choose the image within Alfred but nothing happens: https://cloud.paulm.in/jfjj4E

[Mr Pennyworth]

@paulminors are using macOS Catalina or Big Sur?

I just realized that URL handling in Big Sur has changed from what it used to be in Catalina.

If you could confirm you're on Big Sur, that'll make for an easy fix and I can update the workflow immediately.

[paulminors]

Quote

@paulminors are using macOS Catalina or Big Sur?

 

@Mr Pennyworth Thanks for the response. I'm using Big Sur.

[Mr Pennyworth]

@paulminors I uploaded a "fix" https://github.com/mr-pennyworth/alfred-cleanshot/releases/download/0.0.5/CleanShot.alfredworkflow

 

Can you try it and see if it works?
Because I don't have Big Sur, it was not possible for me to test it.
Let me know in either cases whether it works or doesn't

[paulminors]

@Mr Pennyworth, that works now! Thanks a lot for your help and for making a great workflow 

[Chris Messina]

On 6/1/2021 at 8:02 PM, Mr Pennyworth said:

• Did you also find out about the cleanshot:// urls from Raycast? If not, please do tell how you went about it, it might come handy for other apps!

 

Yes exactly! It was the Raycast extension that lead me to create my Workflow. 

 

On 6/1/2021 at 8:02 PM, Mr Pennyworth said:

1. Did you extract those icons from CleanShot's assets.car? If not, again, please do tell! (I have zero design chops or any related abilities, so it might come handy to me later on)

 

Also yes! 

 

I have a Workflow that will extract Asset Catalogs with a hotkey. I use it constantly! Let me know if I should release it.

 

BTW, I'm in touch w/ the Cleanshot developer. If there are features or improvements you'd like to suggest, let me know! 

 

[Mr Pennyworth]

2 hours ago, Chris Messina said:

I have a Workflow that will extract Asset Catalogs with a hotkey. I use it constantly! Let me know if I should release it.

Yes, please! 😊

 

2 hours ago, Chris Messina said:

BTW, I'm in touch w/ the Cleanshot developer. If there are features or improvements you'd like to suggest, let me know! 

Could you ask them where they store the shortcuts?

It would be nice to list those shortcuts as subtitles for the workflow! 😇

[Chris Messina]

17 hours ago, Mr Pennyworth said:

Yes, please! 😊

 

 

Sure — here you go. LMKWYT.

 

17 hours ago, Mr Pennyworth said:

It would be nice to list those shortcuts as subtitles for the workflow! 😇

 

I've requested public documentation and the developer seemed willing to provide it!

[Mr Pennyworth]

@Chris Messina CleanShot just added OCR capabilities: https://cleanshot.com/changelog

Would it be possible for you to ask them to expose the functionality through a URL just like everything else?

[Chris Messina]

15 hours ago, Mr Pennyworth said:

Would it be possible for you to ask them to expose the functionality through a URL just like everything else?

I will ask.

[Bemawr]

Just started using CleanShot X a few weeks ago this is an amazing workflow great job!

[Mr Pennyworth]

8 hours ago, Bemawr said:

Just started using CleanShot X a few weeks ago this is an amazing workflow great job!

Thanks! 😊

[Praxder]

This is a great workflow. Thanks! 👍🏻

[Chris Messina]

On 7/1/2021 at 12:44 AM, Chris Messina said:

I will ask.

 

Ask and ye shall receive! 

 

/cc @Mr Pennyworth

[Samplex]

Had to do this after trying the workflow

 

Do the following immediately after you get the warning: "[application-xyz] cannot be opened because the developer cannot be verified."

 

1. Click "Cancel" on the warning dialog.
2. Open Mac System Preferences
3. Open Security & Privacy section, then the General tab
4. At the bottom in the "Allow apps downloaded from" section, you should see a message that says: "[application-xyz] was blocked from use because it is not from an identified developer."
5. Click the "Allow Anyway" button
6. Try to run the workflow again
7. You will get another warning about not being able to identify the developer, but now it has an Open button. Click Open.
8. You show now be able to run the workflow without any future problems (until you upgrade the workflow).

[TomBenz]

On 6/1/2021 at 9:07 PM, Mr Pennyworth said:

CleanShot X Workflow: Download

 

Requiremens

 

• Alfred 4
• CleanShot X (version 3.5.1 or above)

 

does this required paid application CleanShot? or is command line tool from Brew free to use? What are other workflows that allow you to take screenshot and annotate them easily? 

[Shauli]

can you please update it so it will work on alfred 5.1.1?

 

[json12]

This has stopped working for me. Is anyone else having this issue? I can see list of options to but when I select in Alfred, nothing happens.

[Chris Messina]

On 10/23/2023 at 9:34 AM, json12 said:

This has stopped working for me. Is anyone else having this issue? I can see list of options to but when I select in Alfred, nothing happens.

 

Which version of macOS are you on? 

 

On Sonoma, when I attempted to use the workflow, I was shown this permission dialog and accepted the request, and it worked fine.

 

Perhaps there's a permission issue?