Predefined Library Fields

From wiki.jriver.com
Jump to navigation Jump to search

See also:Library Fields


The table below lists Media Center's default fields. The rows list the available fields, and the columns indicate how the field is defined, and gives a brief explanation of the fields usage or meaning. Where applicable, additional links and field-specific information is also listed. The value for some fields is calculated by Media Center. When possible, the expression used to derive this value is also shown. In some cases, this value may be modified. Beneath a field name is a list of the default Search Keyword(s), if available, which are used for field-specific searching within Media Center.

The Save column indicates if the field is saved in file tags (prior to version 16.0.154, Media Center used the term Stored in the Manage Library Fields dialog). The Search column indicates if the field should be searched when using Media Center's Search area.

Note: Default Search Field. Beginning with MC17, the Default search field setting is not used for stock fields; instead searching fields relies on rules built into the program. Nearly all stock fields are now searched by default. User-defined fields will honor this setting.

Note: Legacy Fields. Some fields are legacy fields, possibly created during an upgrade from a previous version of Media Center. These are noted as "Legacy:" in the Description column. Your Library may not contain these fields.

Note: Some fields are used internally by Media Center to maintain state information, and are not viewable in panes, categories, or the Tag Action Window. These are typically configured through various options and settings dialogs.

Fields

Media Center Predefined Fields
 Field Name
 search keyword(s)
Media Types  S 
a
v
e
 S 
e
a
r
c
h
Data Type
Edit Type
Relational
Description

A - C

 Access Rating
 accessrating=
Audio Image Video Data TV      String
Standard
Specifies the access rating when access control is in effect.

See also: Access Control

 Actors
 actors=
Audio Video       List
List
A semicolon-separated list of a movie's actors.
 Album
 album=  al=
Audio Image Video Data TV     String
Standard
The name of the album.
 Album Artist
 albumartist=
Audio      String
Standard
Designates the artist to use for compilation albums.

See also: Album Artist and Album Artist (Auto)

 Album Artist (auto)
 autoalbumartist=
Audio       String
Calculated, Editable
Automatically calculated based on the contents of an album's Artist tracks.

Expression: AlbumArtist()

See also: Album Artist and Album Artist (Auto)

 Album Gain
 albumgain=  ag=
Audio       Decimal
Clear-only
Automatically calculated gain for an album, based on Replay Gain. Obsolete in MC19.

See also: Album Gain

 Album Type
 albumtype=
Audio       String
Calculated, Not editable
Automatically calculated value indicating if the album has a single artist or multiple artists, and if the album is complete.

Expression: AlbumType()

See also: Multiple Artist Albums#Complete Albums

 Altitude Image       String
Standard
Camera's GPS altitude when photo was taken.

See also: Photo Tagging

 Aperture Image       String
Not editable
Camera's aperture setting used to create the photo.

See also: Photo Tagging

 Artist
 artist=  ar=
Audio Image Video Data TV     List
Standard
Track artist, or movie's director.

See also: Album Artist and Album Artist (Auto), YADB

 Artist - Album (Year) Audio       String
Calculated, Not editable
Automatically calculated field used for album grouping.

Expression: Clean([Artist] - [Album] /([FormatDate([Date, 0), Year)/))

 Aspect Ratio
 aspect=
Video       String
Standard
Video aspect ratio.
 Audio Analysis Info Audio       String
Not editable
Automatically calculated data created and used by audio analysis engine.

See also: Audio Settings and Analysis, Analyze Audio

 Author Audio Data       List
List
A semicolon-separated list of a document's authors.
 Band
 band=  bd=
Audio     String
Standard
Designates a track's band.
 Bios
 bios=  bio=
Audio      String
Large
Legacy: Musicmatch musician or group biography.
 Bit Depth
 bitrate=
Audio Video       Integer
Not editable
Audio / video bit depth.
 Bitrate Audio Video      Integer
Not editable
Audio / video bitrate, in bits per second (bps).
 Bookmark Audio Video       String
Clear-only
Specifies the bookmark location for resumption of playback.

See also: Bookmarking

 BPM
 bpm=
Audio      Integer
Standard
Beats-per-minute, calculated automatically during audio analysis.
 Budget Video       String
Standard
A movie's financial budget.
 Camera Image      String
Standard
Camera EXIF tag.

See also: Photo Tagging

 Caption
 caption=
Image     String
Standard
An image's caption.
 Catalog # Audio Image Video Data TV      String
Standard
***TBD***
 Category Image Category Image       String
Not editable
***TBD***
 Channels Audio Video       Integer
Not editable
Number of playback channels
 Cinematographer Video       List
List
A semicolon-separated list of a movie's cinematographer(s).
 Comment
 comment=  c=
Audio Image Video Data TV     String
Standard
A general use comment field.
 Complete Album
 completealbum=
Audio       Integer
Not editable
Indicates if an album is a complete album.

See also: Multiple Artist Albums#Complete Albums

 Composer
 composer=
Audio     List
Standard
The composer of a piece or work, typically used with classical music.
 Compression Audio Video       String
Not editable
The compression type and scheme used for compressed audio/video.
 Conductor
 conductor=
Audio      List
Standard
The conductor of a piece or work, typically used with classical music.
 Country
 country=
Audio Image Video Data TV       List
List
A semicolon-separated list of countries relevant to the media.
 Credits
 credits=
Video       List
List
A semicolon-separated list of movie credits.
 Critic Rating Audio Image Video Data TV       String
Standard
Critic Rating, like Rotten Tomato or Allmusic score.
 Custom Audio Image Video Data TV      String
Standard
General use custom field.
 Custom 1 Audio Image Video Data TV      String
Standard
General use custom field (may not exist).
 Custom 2 Audio Image Video Data TV      String
Standard
General use custom field (may not exist).
 Custom 3 Audio Image Video Data TV      String
Standard
General use custom field (may not exist).

D - F

 Date
 date=  d=
Audio Image Video Data TV      Date
Standard
General date of media.
 Date (day) Audio Image Video Data TV       Integer
Calculated, Editable
Day of month segment of Date.

Expression: FormatDate(Day)&DataType=[Integer]

 Date (filename friendly) Audio Image Video Data TV       String
Calculated, Not editable
A version of Date that has been cleaned for use in filenames.

Expression: FormatDate(Filename)

 Date (month) Audio Image Video Data TV       String
Calculated, Editable
Month segment of Date.

Expression: FormatDate(Month)&DataType=[Month]

 Date (year)
 year=
Audio Image Video Data TV       Integer
Calculated, Editable
Year segment of Date.

Expression: FormatDate(Year)&DataType=[Number]

See also: YADB

 Date Created Audio Image Video Data TV       Unknown
Not editable
A file's creation date/time as reported by the system.
 Date Imported
 dateimported=
Audio Image Video Data TV       Unknown
Not editable
The date the media was imported into the MC / MJ database.

See also: [1]

 Date Modified Audio Image Video Data TV       Unknown
Not editable
A file's modification date/time, as reported by the system.
 Date Recorded Video TV      Date
Standard
The date/time of a video recording.
 Description Audio Image Video Data TV     String
Large
A general description of the media.
 Dimensions Image Video       String
Calculated, Not editable
Automatically calculated image/video dimensions.

Expression: Clean([Width] x [Height])

 Direction Image       String
List
Camera's directional heading when photo was taken.

See also: Photo Tagging

 Director
 director=
Audio Video       List
Standard
A semicolon-separated list of a movie's directors.
 Disc # Audio Video     Integer
Standard
The disc number, for multi-disc audio or video sets.

See also: Multidisc Albums

 Distributor Video       List
List
A semicolon-separated list of a movie's distributors.
 DLNA Server Info Audio Image Video Data TV       String
Not editable
Internal information for the MC DLNA server.
 Duration
 length=  duration=
Audio Video       Unknown
Not editable
The duration of an audio / video track.
 DVD Video Info Video       String
Standard
Internal information used for a DVD.
 Dynamic Range (R128) Audio Video      Integer
Clear-only
An automatically calculated value indicating R128 Dynamic Range (overall dynamic range).

See also: [2]

 Dynamic Range (DR) Audio Video      Integer
Clear-only
An automatically calculated value indicating Dynamic Range (crest factor).

See also: [3]

 Edit Info Image       String
Not editable
Internal information used for image editing.
 Editor Audio Image Video       List
List
A semicolon-separated list of the editor(s) used to capture/create a video.
 Embedded CUE Audio       String
Not editable
Automatically calculated data indicating file uses embedded CUE file.
 Encoding Settings Audio Image Video Data TV       String
Standard
Description
 Episode Audio Video TV      String
Standard
Episode number of a television / video series.
 Episode URL Audio Image Video Data TV      String
Not editable
URL of a single podcast episode.
 Events
 events=
Audio Image Video Data TV     List
List
A semicolon-separated list to specify relevant events for the media.
 Feed URL Audio Image Video Data TV      String
Not editable
URL of a podcast feed.
 File Size
 size=
Audio Image Video Data TV       Unknown
Not editable
A file's on disc size (human readable, unitized and rounded).
 File Type
 filetype=
Audio Image Video Data TV      String
Standard
The type of file (e.g. mp3, jpg, flac, pdf).
 Filename
 filename=  location=
Audio Image Video Data TV      Unknown
File
The full pathname to the location of a file.
 Filename (name) Audio Image Video Data TV       String
Calculated, Editable
The name-only portion of [Filename].

Expression: FileName()

 Filename (path) Audio Image Video Data TV       Unknown
Calculated, Editable
The path-only portion of [Filename].

Expression: FilePath()&DataType[Path]

 Flash Image       String
Not editable
Indicates if a camera's flash was used to take image.

See also: Photo Tagging

 Flickr Info Image Video       String
Not editable
Description
 Focal Length Image       String
Not editable
The lens focal length used when a image was captured.

See also: Photo Tagging

 FPS
 framerate=  fps=
Video       Decimal
Standard
The number of frames-per-second in a video/movie.

G - I

 Genre
 genre=  g=
Audio Image Video Data TV     List
Standard
Genre of media.

See also: YADB

 Get Cover Art Info Audio Video Data       String
Not editable
Description
 Get Metadata Info Audio Video Data       String
Not editable
Description
 Gross Revenue Video       String
Standard
A movie's gross reported revenue.
 Grouping Audio Image Video Data TV      String
Standard
For support of the iTunes Grouping field.

See also: [4]

 Height
 height=
Image Video       Integer
Not editable
The height dimension of an image/video (see also Dimensions above).
 Image File
 imagefile=
Audio Video      Unknown
Not editable
The name of the associated artwork for audio/video.

See also: Cover Art

 IMDb ID Video      Unknown
Standard
The unique Internet Movie Database identifier for video lookups.
 Instrument Audio      String
Standard
A song's primary instrument.
 Intensity
 intensity=
Audio      Integer
Standard
A musical intensity metric automatically calculated during audio analysis. Obsoleted in MC19.
Values: 1, 2, 3, 4, 5
 ISO Image       String
Not editable
The ISO standard film speed used when an image was captured.

See also: Photo Tagging

 Keywords
 keyword=  keywords=  kw=
Audio Image Video Data TV     List
List
A semicolon-separated list of user-defined keywords.
 Language Audio Image Video Data TV       List
List
A semicolon-separated list of languages.
 Last Played
 lastplayed=
Audio Image Video Data TV       Unknown
Clear-only
Date / time the file was last played or viewed.
 Last Skipped
 lastskipped=
Audio Image Video Data TV       Unknown
Clear-only
Date / time the file was last skipped.

See also: Skip Count

 Latitude Image       String
Standard
Camera's GPS latitude when photo was taken.

See also: Photo Tagging

 Lens
 lens=
Image     String
Standard
Lens description from EXIF tag (Canon cameras).

See also: Photo Tagging

 Library Server Info Audio Image Video Data TV       String
Not editable
Internal information used to manage state for Library Server.
 Library Server Key Audio Image Video Data TV       Integer
Not editable
Internal authorization key used to help secure Library Server.
 Library Server URL Audio Image Video Data TV       String
Not editable
URL used to specify location of Library Server.
 Longitude Image       String
Standard
Camera's GPS longitude when photo was taken.

See also: Photo Tagging

 Lyricist Audio Video      String
Standard
The lyricist responsible for a work.
 Lyrics
 lyrics=
Audio Video      String
Large
User-stored lyrics or transcription.

M - O

 Media Sub Type
 mediasubtype=
Audio Image Video Data TV      String
Standard
More specific sub-classification of Media Type, generally used to drive Media Center behavior in some fashion.
Values: Adult, Audiobook, Book, Educational, Home Video, Karaoke, Movie, Music, Music Video, Other, Photo, Podcast, Radio, Remix, Ringtone, Short, Single, Stock, System, Test Clip, Trailer, TV Show
 Media Type
 mediatype=
Audio Image Video Data TV      String
Standard
General classification of media type.
Values: Audio, Image, Video, TV, Data, Playlist
 Mix Album
 mixalbum=
Audio      Integer
Not editable
Used to specify if an album is a mix album.
 Mood
 mood=
Audio      String
Standard
Legacy: Musicmatch mood classification of a song.
 MPAA Rating
 mpaa=
Video       String
Standard
A movies MPAA rating.
 MPAA Rating Description Video       String
Standard
A textual description of MPAA rating.
 Music By Video       List
List
A semicolon-separated list of people responsible for a movie's music.
 Name
 name=  title=  n=
Audio Image Video Data TV     String
Standard
The primary name associated with a file. When used as thumbnail or caption text, [Name] takes on the name of the current category in Category or Theater views.
 Notes
 notes=
Audio Image Video Data TV      String
Large
General notes associated with a file.
 Number Plays
 numberplays=
Audio Image Video Data TV       Integer
Clear-only
An automatically updated statistic indicating the number of times a file has been played/viewed.

See also: Changing the number of plays

 Orchestra Audio      String
Standard
The name of the orchestra responsible for performing a piece, typically used with classical music.
 Orientation Image      String
Calculated, Not editable
An image's orientation as Landscape, Portrait, or Square.

Expression: Orientation()

 Original Title Audio Image Video Data TV       String
Standard
The original title given to a work.

P - R

 Peak Level
 peaklevel=
Audio      Percentage
Clear-only
An automatically calculated value indicating the percentage of an audio track's maximum level before clipping would occur. Obsoleted in MC19.

See also: Overflow Handling, Technical Information on Replay Gain Adjustment, Analyze Audio, [5]

 Peak Level (R128)
 peaklevel=
Audio Video      String
Clear-only
An automatically calculated value indicating R128 Peak Level in dBTP (aka True Peak Level).

See also: [6]

 Peak Level (Sample) Audio Video      String
Clear-only
An automatically calculated value indicating R128 Peak Level inside the file.

See also: [7]

 People
 people=
Audio Image Video Data TV     List
List
A semicolon-separated list of people associated with a work.
 Period Audio      String
Standard
A musical period, typically used with classical music.
 Places
 places=
Audio Image Video Data TV     List
List
A semicolon-separated list of places associated with a work.
 Playback Channel Key TV       Integer
Not editable
Description
 Playback Device TV       String
Not editable
Description
 Playback Info Audio Video       String
Standard
Description
 Playback Range
 playbackrange=
Audio Video       String
Standard
Specifies the begin and end times for A-B repeat.

See also: Playback Range (A-B Playback)

 Popularity Audio Image Video Data TV       String
Standard
Flexible popularity field (e.g. for web radio, '3123 listeners').
 Preference
 preference=
Audio      String
Standard
Legacy: Musicmatch subjective classification of a user's preference for a song.
 Prequel Video       List
List
The prequel to a movie.
 Producer
 producer=
Audio Image Video Data TV       List
List
A semicolon-separated list of responsible producer(s)
 Protection Type
 protectiontype=
Audio Video       String
Not editable
Indication of the type of DRM protection.
 Publisher Audio Image Video Data TV      String
Standard
A work's publisher.
 Rating
 rating=  r=
Audio Image Video Data TV     Integer
5 Star
A 5-star user rating.
 Read Only
 readonly=
Audio Image Video Data TV       Integer
Not editable
Indicates if the file is read-only.
Values: 0, 1
 Recording Rule ID TV       Integer
Not editable
An internal ID representing a TV recording rule.
 Removable
 removable=
Audio Image Video Data TV       Integer
Calculated, Not editable
Indicates if the file resides on removable media.

Expression: IsRemovable()

 Replay Gain
 replaygain=  rg=
Audio      Decimal
Clear-only
An automatically calculated value indicating the gain to be applied to an audio track. Obsoleted in MC19.

See also: Replay Gain, Album Gain, Audio Settings and Analysis, Analyze Audio

 Rerun TV       Integer
Not editable
Flag indicating if TV show is a rerun.
 Rotation Image       Integer
Standard
The rotation (in degrees) applied to an image.

S - U

 Sample Rate
Audio Video       Integer
Not editable
The rate of sampling for an audio/video file.
 Screenwriter
 screenwriter=
Video       List
List
The screenwriter responsible for a movie. Note: Libraries created prior to 16.0.152 will have the typo "screenwirter" as the keyword. This may be corrected freely.
 Season Video TV      String
Standard
The season of a movie/video series.
 Sequel Video       List
List
The sequel to a movie.
 Series Audio Image Video TV     String
Standard
The series information for a movie or TV show.
 Series Description Audio Image Video TV     String
Standard
A description of the series for a movie or TV show.
 Service: ID Audio Image Video Data TV      String
Not editable
Description
 Service: Item Info Audio Image Video Data TV      String
Not editable
Description
 Service: Name Audio Image Video Data TV      String
Not editable
Description
 Service: Stream Metadata Audio Image Video Data TV       String
Not editable
Description
 Shutter Speed Image       String
Not editable
The shutter speed used to capture an image.

See also: Photo Tagging

 Situation
 situation=
Audio      String
Standard
Legacy: Musicmatch subjective choice of situations for when playing the song would be appropriate or relevant.
 Skip Count
 skipcount=
Audio Image Video Data TV       Integer
Clear-only
An automatically updated statistic indicating the number of times a file has been skipped.

See also: Last Skipped

 Soloists Audio      List
List
A semicolon-separated list of soloists for a music work, typically used in classical music.
 Stack Conversion Type Audio Image Video Data TV       String
Not editable
Unknown, seems currently unused.
 Stack Files Audio Image Video Data TV       String
Not editable
A list of internal IDs that reference each member of the stack. Set only in the stack's top member (auto-generated cache members will also have the ID).
 Stack Tag
 stacktag=
Audio Image Video Data TV       String
Not editable
Used to indicate if file was generated via handheld cache conversion or the Particle system.

Values:' HH Conversion, Particle or empty.
 Stack Top Audio Image Video Data TV       Integer
Not editable
A unique numeric stack ID for each member of a stack, and -1 otherwise.
 Stack View Audio Image Video Data TV       Integer
Not editable
Determines if the stack is expanded (empty) or collapsed (1).
 Store Field: Album ID Audio Image Video Data TV       String
Not editable
Description
 Store Field: Album Popularity Audio Image Video Data TV       Integer
Not editable
Description
 Store Field: Amg Album Review Audio Image Video Data TV       String
Not editable
Description
 Store Field: Amg Artist Bio Audio Image Video Data TV       String
Not editable
Description
 Store Field: Artist ID Audio Image Video Data TV       String
Not editable
Description
 Store Field: Artist Popularity Audio Image Video Data TV       Integer
Not editable
Description
 Store Field: Asset Code Audio Image Video Data TV       String
Not editable
Description
 Store Field: Assosciated Video ID Audio Image Video Data TV       List
Not editable
Description
 Store Field: Available Asset Audio Image Video Data TV       String
Not editable
Description
 Store Field: Download Date Audio Image Video Data TV       Date
Not editable
Description
 Store Field: Genre ID Audio Image Video Data TV       String
Not editable
Description
 Store Field: License Count Audio Image Video Data TV       String
Not editable
Description
 Store Field: License Reissue Count Audio Image Video Data TV       String
Not editable
Description
 Store Field: MP3 Available Audio Image Video Data TV      String
Not editable
Description
 Store Field: MusicNet File GUID Audio Image Video Data TV       String
Not editable
Description
 Store Field: New Release Audio Image Video Data TV       Integer
Not editable
Description
 Store Field: Number of Tracks Audio Image Video Data TV       Integer
Not editable
Description
 Store Field: Playlist Description Audio Image Video Data TV       String
Not editable
Description
 Store Field: Playlist Guid Audio Image Video Data TV       String
Not editable
Description
 Store Field: Playlist Image Audio Image Video Data TV       String
Not editable
Description
 Store Field: Playlist Name Audio Image Video Data TV       String
Not editable
Description
 Store Field: Playlist Type Audio Image Video Data TV       String
Not editable
Description
 Store Field: Purchase Date Audio Image Video Data TV       Date
Not editable
Description
 Store Field: Purchase Description Audio Image Video Data TV       String
Not editable
Description
 Store Field: Ranking Audio Image Video Data TV       Integer
Not editable
Description
 Store Field: Similar Artists Audio Image Video Data TV       String
Not editable
Description
 Store Field: Store Name Audio Image Video Data TV       String
Not editable
Description
 Store Field: Track ID Audio Image Video Data TV       String
Not editable
Description
 Studios
 studios=
Video       List
List
A semicolon-separated list of responsible movie studios.
 Style Audio      String
Standard
A musical style, typically used to further refine genre.
 Tag Line
 tagline=
Video       String
Standard
A movie's branding or slogan.
 Tempo
 tempo=
Audio      String
Standard
Legacy: Musicmatch subjective indication of a track's tempo.
 Text Data       String
Not editable
General text describing a data file.
 TheTVDB Series ID Video TV      Integer
Standard
Relational per-series
The unique TVDB series identifier for video/tv lookups; use when performing Get Movie & TV Info, backdrop artwork queries, etc.
 Thumbnail Info Audio Image Video Data TV       Integer
Not editable
Internal information used for view thumbnails.
 Thumbnail Info (Local) Audio Image Video Data TV       Integer
Not editable
Internal information used for view thumbnails.
 Thumbnail Offset Large Audio Image Video Data TV       Integer
Not editable
Internal information used for view thumbnails.
 Thumbnail Offset Medium Audio Image Video Data TV       Integer
Not editable
Internal information used for view thumbnails.
 Thumbnail Offset Small Audio Image Video Data TV       Integer
Not editable
Internal information used for view thumbnails.
 Track #
 tracknumber=  t=
Audio Image Video     Integer
Standard
The track number of the song within an album. When used as Thumbnail text, will be the total number of files for the grouping.
 TV Channel TV       String
Not editable
The TV channel used for a TV recording.

See also: [8]

 TV Channel Number TV       String
Standard
Defines remote channel number used to tune TV Channel.

See also: [9]

 TV Tuner Input Type TV       String
Not editable
Description
 TV XMLTV ID TV       String
Standard
Stores ID used when mapping a channel to XMLTV data.

See also: [10]

 UPC Audio Image Video Data TV      String
Standard
Universal Product Code.
 User
 u=
Audio Image Video Data TV      Unknown
List
A list of users allowed to see/access the file.

See also: [11]

 Usage Reporting Info Audio Image Video Data TV       String
Not editable
Description
 Use Bookmarking Audio Video       String
Standard
Specifies if bookmarking is active for the track / video.
Values: Default, Yes, No

V - Z

 Video Standard
Video       String
Standard
The encoding/decoding video standard in use (e.g. NTSC, PAL, SECAM).
 Volume Name
 volume=
Audio Image Video Data TV       String
Standard
The name of the volume on which the file resides.

Expression: FileVolume()

 Volume Level (R128) Audio Video      Decimal
Clear-only
An automatically calculated value indicating R128 Volume Level.

See also: [12]

 Volume Level (ReplayGain) Audio Video      Decimal
Clear-only
An automatically calculated value for ReplayGain backwards compatibility.

See also: [13]

 Web Media Info Audio Image Video Data TV      String
Standard
Description
 Web Media URL Audio Image Video Data TV      String
Standard
The URL of a remote media file, or for Scheduler recorded media, the value Recording... or Recorded Media.
 Width
 width=
Image Video       Integer
Not editable
The width dimension of an image/video (see also Dimensions above).
 Year - Album Audio       String
Calculated, Not editable
An combination of Year and Album used for views, sorting, etc.

Expression: Clean(FormatDate([Date, ], Year) - [Album])