Seitenhierarchie

  Wiki Navigation

    Loading...


 Recently Updated


 Latest Releases

 MediaPortal 1.32
            Releasenews | Download
 MediaPortal 2.5
            Releasenews | Download


Table of Contents

Overview

Ant Movie Catalog (AMC) - v 3.5.1 OR 4.1.x - is the default catalog in My Films because it supports an XML database natively.  Thus changes made in either My Films or AMC occur in real time since both applications use the same XML database. Downloads can be found here.

Extended Fields

As of v 6.0.0 My Films supports AMC v 4.1.x with the addition of extended fields.

If you currently use AMC3, see Upgrade to AMC4 for instructions how to add data to the extended fields. 

AMC 3.5.1

Although extended fields are supported for AMC 3 catalogs, the data will be lost IF you save the catalog in AMC

However, there are two ways you can use extended fields in My Films with AMC3 catalog types: 

  1. ONLY use My Films/AMC Updater to update your AMC3 catalog type (never save it in AMC3)
    • Use Custom Display Fields (Display tab in Setup, or Options > Display Options within My Films) to display the extended fields you wish.
  2. Map the extended fields you wish to use to supported AMC3 fields by using the Grabber options (see Grabber Script Editor - Mapping section for details).

Examples,

  • Tagline - Add to start of the Description field
  • Certification - Add to start of (or replace) the Description field
  • Writer - replace Producer field if you normally grab/add writers to the Producer field in AMC (using script options)

Note: Grabber options apply ONLY to a specific grabber/script. 

 Tip: Save your custom grabber under a new name so you can preserve your modifications even when updating grabber scripts, OR so you can select which grabber to use when importing/updating movies.

AMC 4.1

As of v 6.0.0 My Films adds full support for several additional extended fields which will display on the Custom Fields tab in AMC4.1. These fields are all 'synced' with My Films and data is retained when using AMC4.1 catalog type.

WARNING: My Films does not support new custom fields you add in AMC4. Also, If you change field names (even Custom 1-3 fields) within AMC, the data will no longer display in My Films. However, you CAN change the display name - e.g. to show "CustomField1 as "My Personal Comment" field in MyFilms.

The table below lists the extended fields and how they are handled in MyFilms.

Note: the Type field indicates how the data is generated, internally by My Films, i.e. grabbed from websites or generated by Media Info app. The field order matches the alphabetic order in AMC4 on the Custom Fields tab.

Warning: AMC 4.2 is NOT compatible with previous versions, and thus not supported by My Films. For further details See the forum thread: WARNING - AMC 4.2 incompatibility

Extended Field

Type

Notes

Alternate Titles

 

not used in v 6.0.0

Aspect Ratio

Internal

currently generated by My Films and not saved to extended field in v 6.0.0

Audio Channels

MediaInfo

count of audio channels supported in the movie file

Trakt Categories

Internal

when Trakt is enabled for a config Trakt Categories will be synced to this field

Certification

Grabber

grabber scripts will grab certification (ratings) data when importing/updating movies

Custom Field 1

Internal

new AMC4 field - can be used for whatever data you wish

Custom Field 2 

Internal

new AMC4 field - can be used for whatever data you wish  

Custom Field 3

Internal

new AMC4 field - can be used for whatever data you wish  

Edition

 

Can be auto-detected by filename in AMC4 catalog types, or in AMC3 by using using the Database Fields tab in AMCU Setup > Title Handling - see Using My FIlms > Editions for details 

Fanart

internal

fanart filename

Favorite

 

automatically displays the user name when user rating > 7

IMDb ID

Grabber

automatically grabbed from websites that support it to aid in future matches

IMDb Top List

Grabber

not populated /grabbed in v 6.0.0

Online Status

Internal

Boolean True/False - indicates if the film is currently available for playback (when you update online availlability either in My Films > Global Updates, or 'Scan Media on start' in Setup > General tab.

Online Status Trailer 

Internal

Boolean True/False - indicates if a Tralier is currently available for playback (when you 'search and add local trailers' in My Films > Global Updates,

Last Position

Internal

not used in v 6.0.0 

Last Seen      

Internal

Date format - displays the last date watched for current user in My Films

Multi User State

Internal

(v 6.0.0) this field records the watched status, count, date watched and user ratings for multiple users, as well as global watched status for all users - see Multiple Users for details as well as multiple user ratings.

Studio

Grabber

grabbed  from websites that support it (like IMDb) 

Tagline

Grabber

grabbed from websites that support it

Tags

Import Filter

Populated by external catalogs, that support that field

TMDb ID

Grabber

the TMBd ID when using TMDb grabbers

Trailer

Internal

one (or more) trailer filename(s) automatically added when you 'search and add local trailers' in My Films > Global Updates 

User Rating

User

saves a user rating entered via 'User rating' option on Details screen context menu (stored as a 0-100 integer - the last digit is used as decimal part) OR when rating a movie via the Trakt rating popup when Trakt ratings popup is enabled in Trakt plugin settings

Watched

User

Can be selected for watched status so that Checked field can be used for other purposes

Writers

Grabber

grabbed from websites that support it.

When you create a new Config using the Setup Wizard, and select AMC v4.1 catalog type, all extended fields will display in drop down boxes, or field lists for sorting, searching or selecting views within My Film for that config. (Fields in My Films are sorted alphabetically to make them easier to find)

Grabber scripts have been updated to grab data for the extended fields where supported on the source website.

Extended 'Runtime'  Fields

My Films also generates several fields when you open the plugin:

  • IndexedTitle
  • DateAdded
  • RecentlyAdded
  • AgeAdded
  • Persons

These fields are supported for any catalog and can be used within My Films to create Custom Views, or as Custom Display Fields. However, the data is not saved when you exit My Films, and cannot be viewed/used in your movie catalog app, 

Movie fields

The following table lists the main AMC fields supported in AMC3 or in AMC4 on the Movie fields tab. My Films internal format is based mainly on these fields/definitions.

Note: Field types in AMC are Pascal types since AMC is coded in Delhi.  String fields are normally text fields. Data is often grabbed for mulitple values separated by a comma. My Films presets the comma as a separator so you can search, sort or view each value separately.

Field Name

Type

Notes

Number

Integer

Note: the number field in AMC is not necessarily a unique identifier and can change if you renumber your movies

Checked  

Boolean

true/false - this field is often used to indicate watched status 

MediaLabel

string

can be used to store the CD/DVD/BD ID or label you assign for your library

MediaType

string

such as HDD, DVD, CD, NAS, etc

Source

string

usually used for movie filename - can support multiple files for a movie separated by a semi-colon

Date 

Integer 

supports yyyy-mm-dd or current system date format

Borrower

string

not grabbed, but can be manually entered when you lend a movie

Rating

Integer

stored as a 0-100 integer (the last digit is used as decimal part)

OriginalTitle

string

note: different AMC grabber scripts may use this field for either the main Title or the Original Title depending on the source website -

TranslatedTitle

string

note: different AMC grabber scripts may use this field for either the main Title or the Translated Title depending on the source website 

FormattedTitle

string

Formatting is set in AMC Preferences (e.g. to ignore article prefixes or not)

Director

string

automatically grabbed when using grabbers that support is (e.g. IMDB-Full)

Producer

string

AMC grabber scripts may support grabbing Producers or Writers or both in this field . 

Country

string

automatically grabbed if you use a grabber script that supports it

Category

string

usually used for genre

Year

Integer

Year the movie was released

Length

Integer

the runtime or duration of the movie (generated by media info app) in minutes

Actors

string

AMC grabber scripts often support custom options of how many actors (and roles) are grabbed - these options are also supported in My Films grabber scripts for websites that support it.

URL

string

link to the website page where the movie data was grabbed.  However, by default, when you drag/drop files in AMC the movie filename is added to the URL field. In AMC4 when batch importing media files, you can select whatever field you wish for the movie filename.

Description

string

movie plot

Comments

string

user comments if grabbed from websites that supports them or can be used for your own comments

VideoFormat

string

codec or media used for the video file (generated by media info app)

VideoBitrate

Integer

bitrate of the video file (generated by media info app)  in kilobits per second (kbps)

AudioFormat

string

codec or media used for audio (generated by media info app)  

AudioBitrate

Integer

bitrate of the audio (generated by media info app)  in kilobits per second (kbps) 

Resolution

string

Width and Height of the movie (e.g. 640x480) generated by media info app

Framerate

string

Number of images per second (generated by media info app)

Languages

string

languages spoken in the movie - grabbed if source website supports it

Subtitles

string

may be grabbed by some grabbers, but usually must be entered manually 

Size

string

file size(s) in megabytes of the movie. There can be multiple files (e.g. 650+590 or 1240) 

Disks

Integer

Number of disks or files

Picture

string

file name of the picture/movie cover - either full path or relative path based on the preferences you select in AMC

Related

Tutorials

   

 

This page has no comments.