TLDR: Badly organized lazy man with lots of e-clutter wanted easy reverse image search from right-click menu function and had to make a catbox shortcut first so it would work.
Sooo—I had all these disorganized image files downloaded from the internet with file names like "2FI0alKYqxo7REUyA0d0InfxQrf0ad.png" with no metadata and terrible orginizational skills so I went looking for a tool that would enable me to initiate one or more reverse image searches from the right-click context menu in the Finder.
It didn't exist. Long story short, I had to build the catbox upload tool to make the reverse-search one work, and it took me so long to get them both working that I am making them available for free here so nobody has to spend the amount of time I just did for a relatively minor convenience,.
Both tools are possible thanks to MineBartekSA on GitHub, who's catbox-cli API tool is the foundation of both shortcuts. Many thanks to Catbox too, of course, who's free, patreon-supported file hosting site enables both of these tools to work;
Please abide by Catbox's terms of service and don't abuse the privledge of free hosting by uploading illegal content. If you are feeling grateful you can donate or buy some merch to support them, and if you aren't — just look at dropbox's current prices if you need some inspiration.
The reverse image search tool uploads files temporarily to litterbox.catbox.moe, generating a temporary url for your image that is then appended to the visual search prefixes of the four major reverse search providers — images searched with disappear from litterbox after one hour (image retention policies may differ for Google, Yandex, TinEye & Bing though FYI).
I have no affiliation with Catbox LLC, Git/MineBartekSA, Alphabet Inc., Yandex, TinEye or Apple except that I use of things that all of them made.
Everything made available for free on a strictly "as is" basis with no acceptance of liability of any kind blah blah etc., but feel free to contact me if something is broken and I might take a look at it.
Scripts don't run on iOS Shortcuts, period, so neither will either of these apps. You can try and reconfigure them to work without script on iOS, but good luck with that... Do let me know if you actually pull that off, 'cause I would use these on my phone too if I could. These will probably also work only with newer versions of MacOS because the Shortcuts App with integrated script functionality that they run in is relatively new.
Download Version 2.1 from iCloud
Initiate a reverse image search from the right-click context menu or 🌐︎ (=) in Finder on MacOS, with the ability to search for any image on your computer with Google Lens, Yandex, TinEye & Bing Visual Search, all at the same time. Useful for OSINT, research & more.
Version 2.1
Minor bug fix in script.
Version 2.0
New, keyboard ShortCat; In addition to the existing [⌃click] context menu search option, now reverse search images with: [fn-equals] aka 🌐︎ (=)
Painfully ironed out revisions to the script logic resulting in:
Compatibility with files "offloaded" to iCloud Drive as well as local files, after several days spent fixing all the new problems resulting from the added brctl/iCloud handling scripts. Still no SVG support.
Version 1.8
Now fully portable and working with all common image filetypes (except SVG, which work fine in the other ShortCat somehow).
Fully working with Yandex, which was difficult to work the bugs out of due to a complex URL structure.
Searched images uploaded to temporary storage on Litterbox for one hour.
External script elements fully integrated, fit for human consumption!
Download Version 2.1 from iCloud
Upload files to catbox.moe or litterbox from the right-click context menu or 🌐︎ (-) directly from the Finder on MacOS. After a few seconds, the uploaded file URL will be copied to your clipboard.
Version 2.1
Minor bug fix in script.
Version 2.0
New keyboard ShortCat; In addition to the [control⌃/right-click] context menu upload option, now upload files to Catbox & Litterbox with: [fn-minus] aka 🌐︎ (-)
Excruciatingly debugged the script logic resulting in:
Full compatibility with files "offloaded" to iCloud Drive as well as local files, after several days spent fixing all the new problems resulting from the added brctl/iCloud-stub handling scripts.
Version 1.6
Fixed an error occuring only with SVG files.
Version 1.5
External script elements fully integrated, so the shortcut should now be able to run without dependencies.
Temporary litterbox uploads now supported! Set custom expiration times from 1-72 hours in the new litterbox menu.
Alternative upload options if file is above catbox's limit added.
BTC: bc1qajz4zcarstnzm5sh5c70e43l9zd49ug45yr3g3
XMR: 48qMQo4aUoH1XmaNSCowmo35c4qpUm5Jp9uN1BFQccB5dDUBD1P5txiK5fWn8U5q7HD37iwY9d1Dn9T5NuZWV2nrFGWPudb
LTC: ltc1q5xavwp3p4m2kwewvawupzjh93f5taccxlavjm0
ETHER: 0xCEdF024875457c660b1eBC5f0af86Ae227164855
DOGE: RIP to the greatest memecoin, deD by eLoN TrUkc.
Original source code for MineBartekSA's catbox-cli tool on GitHub. Earlier versions of my script used this as a dependency, with significant elements added such as the ability to detect and download files managed by iCloud Drive (in most cases, you might want to pre-download REALLY big files), which was an enormous pain in the ass, let me tell you. From 2.0 ShortCats have fully integrated the curl functions from catbox-cli and are now fully portable.
Caption for image above: Toilet Cat.
Google sites weathered stock footage man.