You are on page 1of 6

EASYFIND

Thank you for using EasyFind. EasyFind is an alternative to or supplement of


Spotlight and finds files, folders or contents in any file without the need for in-
dexing and therefore immediately. This is especially useful if you are tired of slow
or impossible indexing, outdated or corrupted indexes, or if you are just looking
for missing features like case sensitive or insensitive search, Boolean operators
and wildcards or searching for phrases.

In addition, EasyFind uses multithreading and is therefore very responsive even


with multiple search processes running, provides contextual menus and Services
and displays the location of each item in a separate column for a better overview.
Finally EasyFind uses little memory, supports drag-and-drop and the clipboard
and finds optionally invisible items or items within packages.

SYSTEM REQUIREMENTS

Every Mac with at least Mac OS X 10.3.9 and 256 MB of RAM.

INSTALLATION/UPDATING

Copy EasyFind to the Applications folder or any other directory you have access
to. To make the Services work, log out and log in again after you have started
EasyFind at least once. EasyFind must be placed into the main Applications
folder or ~/Applications to work.

USAGE

Start EasyFind using the Finder or the Services menu (EasyFind > Find In
Path… or EasyFind > Find Selection…) within Cocoa applications or Carbon ap-
plications supporting services, enter your keywords, select the desired volume or
folder and press the Return or Enter key or click on the search button. You may
also open additional search windows in the meantime, run multiple processes at
once, or stop the currently running search (once you’ve started a search, the
Search button becomes a Stop button until the process has finished).

EasyFind displays all found items immediately so it's possible to drag-and-drop


an item, e.g. onto Finder windows, the dock or other applications, even while the
search is going on (vertical motion begins a multiple file selection, horizontal mo-
tion starts drag-and-drop). Or select Open in the File menu to open one or more

© 2001—2007 DEVONtechnologies, LLC www.devon-technologies.com


files with the appropriate application — or just double click on them —, ‘Reveal
In Finder’ to open the enclosing folder in the Finder, ‘Destroy’ to delete the items
(after a warning) immediately, ‘Move To Trash’ to trash them (without a warning)
or ‘Show Info’ to display the Finder’s info panel for the selected items. You may
also use contextual menus by right-clicking or control-clicking on selected items
to perform these actions.

SEARCH OPTIONS

EasyFind offers a number of options that define how the search is conducted. Use
them to search only within a selected folder, use Boolean operators to refine your
search, or search the contents of the files, not only their names.

• Select the folder or volume to search in. This pop-up includes all mounted vol-
umes, all visible folders within the root directory (‘/’), within your home direc-
tory, on your desktop, your favorites, and all folders inside the directory ‘~/
Library/EasyFind’. EasyFind resolves aliases while initializing this menu (but
not while searching) and automatically removes duplicate folders. If you want
to extend this menu, just add or remove items to your favorites (‘~/Library/
Favorites’) or to EasyFind's user-defined directory (‘~/Library/EasyFind’). Or
use the Select… command to specify any folder. You can also drag folders from
the Finder to the EasyFind window to set it as search destination.
• Look for file and folder names, only file names, only folder names, or file con-
tents.
• Find files with all keywords (‘All Words’), with at least one keyword (‘Any
Word’) or find exact phrases (‘Phrase’), use wildcards including prefixes and
suffixes (‘Wildcards’) or Boolean operators (‘Boolean’). For the available wild-
cards and Boolean operators, see below.
• Find case insensitive, find also invisible files and folders, include package con-
tents in search, and sort by name, date, size or location (ascending and de-
scending).
• Settings for content searching: Define or turn on and off up to six different lists
of file extensions and HFS types (usually only plain text files, each extension or
HFS type separated by commas, HFS types within single quotes like ‘TEXT’)
used for content searching. As EasyFind uses no indexing, this is necessary to
improve performance, but it's also possible to scan all files.

© 2001—2007 DEVONtechnologies, LLC www.devon-technologies.com


WILDCARDS

Wildcard Function

* Matches none, one, or multiple characters

[a-b] Matches a range of characters

[a|b|c|…] Matches a choice of characters


[abc…]
[^…] Excludes characters

? Matches exactly one character

Example Result

Demo* Everything starting with ‘Demo’ (Prefix)

*ing Everything ending with ‘ing’ (Suffix)

NS*.h Everything starting with ‘NS’ and ending with ‘.h’ (e.g.
all Cocoa header files)
?ouse All words with five characters and ending with ‘ouse’
(e.g. ‘mouse’ or ‘house’)
[a-ez]* Everything starting with ‘a’, ‘b’, ‘c’, ‘d’, ‘e’, or ‘z’
[d-fk-j]*[gh] Everything starting with ‘d’, ‘e’, ‘f’, ‘k’, ‘i’, or ‘j’, and end-
ing with ‘g’ or ‘h’
[^be]* Everything not starting with ‘b’ or ‘e’

BOOLEAN OPERATORS

The syntax of EasyFind’s Boolean operators is identical to the one of


DEVONagent.

Operator Function

AND, BUT, +, & Logical And

OR, | Logical Or

NOT, -, ! Logical Not

© 2001—2007 DEVONtechnologies, LLC www.devon-technologies.com


Operator Function

~ Proximity to match partial words/substrings, too (other-


wise only complete words are accepted). Appended to the
end of a word
XOR, EOR, ^ Logical Exclusive Or
NEAR Matches words within a range of ten words
NEAR/n Matches words within a range of n words
AFTER, BEFORE, Matches words appearing before or after each other. Can
NEXT be combined with /n, see NEAR/n.
() Parenthesis, groups parts of the query logically
"" Phrases, find exactly the string in the quotes

TIPS AND TRICKS

• Dropping a folder onto a search window uses this folder as the search location.
• You can copy selected results to the clipboard and insert them into other appli-
cations (e.g. TextEdit).
• Size and order of columns, sorting of results and size of windows are all persis-
tent (for each window on its own).
• To move selected results to a particular folder, drag the results from EasyFind
to the Finder.
• To copy selected results to a particular folder, drag the results from EasyFind
to the Finder while pressing the Option key.
• To create aliases of selected results, drag the results from EasyFind to the
Finder while pressing the Command and Option keys.
• Pressing Command-dot cancels a running search, too.

CUSTOMIZATION

If you want to remove unnecessary Services or change the menus or shortcuts,


you have to edit the file ‘info.plist’ within the EasyFind package (use contextual
menus in the Finder to show the contents).

• Delete elements of the array ‘NSServices’ to remove unnecessary Services.


• Change the ‘default’ element of ‘NSKeyEquivalent’ dictionaries to adapt short-
cuts.
• Change the ‘default’ element of ‘NSMenuItem’ dictionaries to adapt the name
or structure of menu items.

© 2001—2007 DEVONtechnologies, LLC www.devon-technologies.com


CREDITS

Icon by Martin Libich


E-Mail mlib@mac.com

CONTACT

Do you want to send us comments, bug reports or feature requests concerning


EasyFind? Do you have any questions about our products, our technology or our
company? Do you work for the press or are you an investor? Please do not hesi-
tate and feel free to contact us at any time.

http://www.devon-technologies.com/about/contact.html

© 2001—2007 DEVONtechnologies, LLC www.devon-technologies.com


LICENSE AGREEMENT

PLEASE READ THIS LICENSE CAREFULLY BEFORE USING THIS SOFT-


WARE. BY USING THIS SOFTWARE, YOU ARE AGREEING TO BE BOUND
BY THE TERMS OF THIS LICENSE AGREEMENT. IF YOU DO NOT AGREE
TO THE TERMS OF THIS LICENSE, DELETE THE SOFTWARE OR RETURN
THE SOFTWARE AND RELATED DOCUMENTATION TO
DEVONTECHNOLOGIES LLC.

1. License. The application and other components (sound and graphics) accompa-
nying this License, whether on disk, in read only memory, or on any other media
(the ‘Software’), and the related documentation are licensed to you by
DEVONtechnologies. You own the disk on which the Software is recorded but
DEVONtechnologies and/or DEVONtechnologies' Licensor(s) retain title to the
Software and related documentation. This License allows you to non-
simultaneously use the Software on multiple computers by the same person.

2. The Software contains copyrighted material, trade secrets and other proprie-
tary material and in order to protect them you may not decompile, reverse engi-
neer, disassemble or otherwise reduce the Software to a human-perceivable form.
You may not sub-license, modify, rent, lease, or create derivative works based
upon the Software in whole or in part. You may not distribute the Software in any
form, including, but not limited to, electronic information service distribution,
bulletin board distribution, and magnetic or optical medium distribution.

3. Disclaimer of Warranty on Software. You expressly acknowledge and agree that


use of the Software is at your sole risk. The Software and related documentation
is provided ‘AS IS’ and without warranty of any kind.

4. Limitation of Liability. UNDER NO CIRCUMSTANCES INCLUDING NEG-


LIGENCE, SHALL DEVONTECHNOLOGIES BE LIABLE FOR ANY INCI-
DENTAL, SPECIAL OR CONSEQUENTIAL DAMAGES THAT RESULT FROM
THE USE OR INABILITY TO USE THE SOFTWARE OR RELATED DOCU-
MENTATION. In no event shall DEVONtechnologies' total liability to you for all
damages, losses and causes of action (whether in contract, tort (including negli-
gence) or otherwise) exceed the amount paid by you for the Software.

Apple, Carbon, Classic, Cocoa, Colorsync, Darwin, Mac OS X, Quicktime, Quartz


and all other registered names are trademarks of their respective owners.

© 2001—2007 DEVONtechnologies, LLC www.devon-technologies.com