Table of Contents       5. Find


5.7 NeoFinder Search URLs

A unique new way to quickly invoke a Find from outside NeoFinder are the unique Find URLs. These allow you to integrate NeoFinder into web sites, or send interesting Find requests by email or simply save them for quicker access.

Since this is a very new feature, we are also excited to hear about how you are using it. Please let us know if you have any more specific needs or ideas, and send us cool queries!

The NeoFinder URLs follow the usual URL schemes, beginning with the protocol name, here "
neofinder://", followed by the "find" verb, which is then followed by the find parameter. All verbs are divided by the "/" character, while the actual parameters are using the ampersand "&" character to identify them as types.

Here is a list of all currently possible commands. Please remember that these are URLs, so any special character and even blanks must be encoded properly, such as %20 for blanks.

To use them, simply copy them into a browser window, or drag them to the desktop, where they will be saved as "Internet Location" files, which you can then double click to run them.

The "neofinder://" protocol name will cause macOS to launch your NeoFinder, if it isn't running already, and then send it the query string.

Also, NeoFinder does still accept and understand the old "
cdfinder://" URLs as well, so if you have existing integrations with CDFinder, you can keep using them.

neofinder://find/any/&contains&name=Meat%20Loaf
This is the same as the Any Text field search.

File related parameters:
neofinder://find/file/&contains&name=Supertramp
neofinder://find/file/&size=256
neofinder://find/file/&smaller&size=256
neofinder://find/file/&larger&size=256

You can also search for folders:
neofinder://find/folder/&name=2013

Song related parameters:
neofinder://find/audio/&album=Crime%20Of%20The%20Century
neofinder://find/audio/&artist=Roger%20Hodgson
neofinder://find/audio/&song=Open%20The%20Door

IPTC picture related parameters:
neofinder://find/iptc/&any=Canada
neofinder://find/iptc/&caption=Cupertino&contains
neofinder://find/iptc/&caption=California
Other IPTC commands include "writer", "headline", "objectname", "keyword", "category", "author", "title", "credit", "source", "instructions", "date", "dateanyear", "dateafter", "datebefore", "city", "state", "country", "reference", "copyright", "priority", and "hasiptc".

EXIF related parameters:
neofinder://find/exif/&any=Nikon
neofinder://find/exif/&iso=1600
neofinder://find/exif/&exposure=0.0166666667&larger
neofinder://find/exif/&exposure=0.0166666667
neofinder://find/exif/&exposure=0.0166666667&smaller
neofinder://find/exif/&exposure=5.01
neofinder://find/exif/&fstop=22
neofinder://find/exif/&fstop=4
neofinder://find/exif/&fstop=4&larger
neofinder://find/exif/&fstop=4&smaller
neofinder://find/exif/&flash=1
neofinder://find/exif/&flash=0
neofinder://find/exif/&hasGPS
neofinder://find/exif/&hasEXIF

And, most important, GPS related commands:
neofinder://find/gps/&city=Berlin&distance=12000m
neofinder://find/gps/&city=San%20Francisco
(by default in this case, NeoFinder will assume a distance of 5000 meter around that point, if you don't provide one.)
neofinder://find/gps/&city=Golden%20Gate%20Bridge&distance=2000m

And where is this, and who has the most photos taken there?
neofinder://find/gps/&lat=37.331692105787731&long=-122.03065752499016&distance=20m