The status of a WebShare/PrintPreview annotation. (annotationindexer)
This attribute can take the values:
0 = No status
1 = Status OK
2 = Status rejected
List of attribute keys, including their aliases, that are common to all file types. Some attributes are only set by specific modules:
The listed aliases can replace the metadata attributes in a simple search request. In a Spotlight search on Mac OS X, the Finder “translates” these aliases to the corresponding metadata attributes. On Mac OS X, the aliases depend on the specified OS language, so that the alias names stated here are only valid if the Finder is set to English! For other OS languages refer to the Apple Help item “Specifying criteria in the Spotlight search field”.
Please note that attribute names are case-sensitive!
The author, or authors, of the contents of the file. (annotationindexer, oiindexer, officeindexer, pdfindexer)
Identifies city of origin according to guidelines established by the provider, e.g. “New York”, “Berlin”, or “Toronto”. (oiindexer)
A comment related to the file. This comment is not displayed in the Mac Finder. (mediaindexer, officeindexer, oiindexer)
The date and time that the content was created, e.g. the shooting date recorded by a digital camera. (oiindexer)
Date and time when the content of this item was modified. (all files and folders)
The last two attributes share the same alias (“date”). So if you search one attribute by alias you will also get results for the other.
Uniform Type Identifier of the file. For example, a JPEG image file will have a value of “public.jpeg”. (mediaindexer, officeindexer, oiindexer, pdfindexer, txtindexer)
Copyright owner of the file contents. (mediaindexer, oiindexer)
The full, publishable name of the country or primary location where the intellectual property of the item was created, according to guidelines of the provider. (oiindexer)
Name of the application used to create the document content. For example, “Photoshop” or “RagTime”. (mediaindexer, officeindexer, oiindexer)
Description of the kind of item this file represents. (officeindexer, oiindexer, pdfindexer)
The file name. (all files and folders)
The date when this item will be due. (annotationindexer)
Applications used to convert the original content into its current form. For example, a PDF file might have an encoding application set to “Distiller”. (mediaindexer, officeindexer, pdfindexer)
Finder comments for this item. (all files and folders)
Publishable entry providing a synopsis of the contents of the item. For example, “HELIOS receives FograCert”. (mediaindexer, oiindexer)
Formal identifier used to reference the resource within a given context. For example, the message ID of a mail message. (mediaindexer, officeindexer, oiindexer)
Instructions concerning the use of the item, such as embargoes and warnings. For example, “Don't feed after midnight”. (oiindexer)
Keywords associated with this file. For example, “Birthday”, “Important”. (mediaindexer, officeindexer, oiindexer, pdfindexer)
Description of the kind of item this file represents. (mediaindexer, officeindexer, oiindexer, pdfindexer, txtindexer)
Number of pages in the document. (officeindexer, oiindexer, pdfindexer)
Height of the document page, in points (72 points per inch). For PDF files this indicates the height of the first page only. (pdfindexer)
Width of the document page, in points (72 points per inch). For PDF files this indicates the width of the first page only. (pdfindexer)
Publishers of the item. For example, a person, an organization, or a service. (mediaindexer, officeindexer, oiindexer)
Contains the year in that a document was published for the first time. (mediaindexer)
Encryption method used to make the item secure. PDF files return “None” or “Password Encrypted”. (pdfindexer)
Contains a text representation of the content of the document. Data in multiple fields are combined using a whitespace character as a separator.
Applications can create queries using this attribute, but are not able to read the value of this attribute directly. (officeindexer, oiindexer, pdfindexer, txtindexer)
Title of the item. For example, this could be the title of a document, the name of a song, or the subject of an e-mail message. (annotationindexer, mediaindexer, officeindexer, oiindexer, pdfindexer)
Version number of the item. (pdfindexer)
Describes where the item was obtained from. For example, a downloaded file may refer to the URL, files received by e-mail may indicate the sender’s e-mail address, message subject, etc. (mediaindexer, oiindexer)
The following attribute keys are used with image files only. These attributes are only set by the “oiindexer” module.
Manufacturer of the device used to acquire the image.
Model of the device used to acquire the document contents.
Aperture setting used to acquire the image. This unit is the APEX value.
Number of bits per sample. For example, the bit depth of an image (8-bit, 16-bit etc...) or the bit depth per audio sample of uncompressed audio data.
Color space model used by the image. For example, “RGB”, “CMYK”, “YUV”, or “YCbCr”.
Exposure time used to capture the image.
Whether a camera flash was used to capture the image.
Diameter of the aperture relative to the effective focal length of the lens.
Actual focal length of the lens, in millimeters.
Whether the image has an alpha channel.
ISO speed used to acquire the image. For example, 100, 200, 400, etc.
Smallest F number of the lens in APEX value units, usually in the range of 00.00 to 99.99.
Metering mode used to acquire the image.
Orientation of the document contents.
Height, in pixels, of the contents. For example, the image height or the video frame height.
Width, in pixels, of the contents. For example, the image width or the video frame width.
Name of the color profile used by the image.
Resolution height, in dpi, of the image.
Resolution width, in dpi, of the image.
The last two attributes share the same alias (“dpi”). So if you search one attribute by alias you will also get results for the other.
File system metadata attributes are not indexed in the database and hence cannot be searched for, but they can be displayed for each file, e.g. with “dt ftinfo”:
File contents modification date.
File contents creation date.
Resource creator information.
The Finder flags.
Whether the file has a custom icon.
Whether the file is invisible.
Index of the Finder label of the file. Possible values are 0 through 7.
File name of the item.
Group ID of the owner of the file.
User ID of the owner of the file.
Size, in bytes, of the file on disk.
Resource type information.
Complete file path.
Search all files that belong to a group.
The following groups are supported:
| Group ID | Document type |
| 11 | PDF documents |
| 13 | Image files |
| 10 | Media files |
Although the attribute alias names are all documented lower-case in this manual, they can be entered case-insensitive in a Spotlight search.
| Alias | Metadata attribute |
|---|---|
alpha |
kMDItemHasAlphaChannel |
author |
kMDItemAuthors |
bps |
kMDItemBitsPerSample |
by |
kMDItemAuthors |
colorspace |
kMDItemColorSpace |
city |
kMDItemCity |
comment |
kMDItemComment |
copyright |
kMDItemCopyright |
country |
kMDItemCountry |
created |
kMDItemContentCreationDate |
creator |
kMDItemCreator |
date |
kMDItemContentCreationDate kMDItemContentModificationDate |
dpi |
kMDItemResolutionHeightDPI kMDItemResolutionWidthDPI |
flash |
kMDItemFlashOnOff |
from |
kMDItemAuthors |
height |
kMDItemPixelHeight |
intext |
kMDItemTextContent |
iso |
kMDItemISOSpeed |
keyword |
kMDItemKeywords |
kind |
kMDItemKind |
make |
kMDItemAcquisitionMake |
model |
kMDItemAcquisitionModel |
modified |
kMDItemContentModificationDate |
name |
kMDItemDisplayName |
orientation |
kMDItemOrientation |
pages |
kMDItemNumberOfPages |
profile |
kMDItemProfileName |
subject |
kMDItemIdentifier |
title |
kMDItemTitle |
width |
kMDItemPixelWidth |