<!--
{
  "availability" : [
    "macCatalyst: 14.0.0 -",
    "macOS: 10.13.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "iTunesLibrary",
  "identifier" : "/documentation/iTunesLibrary/ITLibMediaItem",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "iTunes Library"
    ],
    "preciseIdentifier" : "c:objc(cs)ITLibMediaItem"
  },
  "title" : "ITLibMediaItem"
}
-->

# ITLibMediaItem

This class describes a media item (a track) in the iTunes library, such as a song, a video, or a podcast.

```
class ITLibMediaItem
```

## Overview

Like all media entities, each media item has a unique identifier and a set of properties.

## Topics

### Getting Media Item Info

[`title`](/documentation/iTunesLibrary/ITLibMediaItem/title)

The title of the media item.

[`sortTitle`](/documentation/iTunesLibrary/ITLibMediaItem/sortTitle)

The title of the media item to use when sorting.

[`artist`](/documentation/iTunesLibrary/ITLibMediaItem/artist)

Information about the artist that iTunes associates with the media item.

[`composer`](/documentation/iTunesLibrary/ITLibMediaItem/composer)

The name of the composer that iTunes associates with the media item.

[`sortComposer`](/documentation/iTunesLibrary/ITLibMediaItem/sortComposer)

The name to use when sorting by composer.

[`rating`](/documentation/iTunesLibrary/ITLibMediaItem/rating)

The rating of the media item.

[`isRatingComputed`](/documentation/iTunesLibrary/ITLibMediaItem/isRatingComputed)

A Boolean value that indicates whether iTunes computes the media item’s rating from its album rating.

[`startTime`](/documentation/iTunesLibrary/ITLibMediaItem/startTime)

If nonzero, the actual time playback of the media item starts instead of 0:00 (in milliseconds).

[`stopTime`](/documentation/iTunesLibrary/ITLibMediaItem/stopTime)

If nonzero, the actual time playback of the media item stops versus the total time (in milliseconds).

[`album`](/documentation/iTunesLibrary/ITLibMediaItem/album)

The album of the media item.

[`genre`](/documentation/iTunesLibrary/ITLibMediaItem/genre)

The genre of the media item, if any.

[`kind`](/documentation/iTunesLibrary/ITLibMediaItem/kind)

The kind of media item file, such as an MPEG audio file.

[`mediaKind`](/documentation/iTunesLibrary/ITLibMediaItem/mediaKind)

The kind of media item.

[`totalTime`](/documentation/iTunesLibrary/ITLibMediaItem/totalTime)

The length of the media item in milliseconds.

[`trackNumber`](/documentation/iTunesLibrary/ITLibMediaItem/trackNumber)

The position of the media item within its album.

[`category`](/documentation/iTunesLibrary/ITLibMediaItem/category)

The podcast category of the media item, if the media item is a podcast.

[`description`](/documentation/iTunesLibrary/ITLibMediaItem/description)

The description of the media item, if it’s a podcast.

[`contentRating`](/documentation/iTunesLibrary/ITLibMediaItem/contentRating)

The content rating of the media item.

[`lyricsContentRating`](/documentation/iTunesLibrary/ITLibMediaItem/lyricsContentRating)

The content rating of the media item’s lyrics.

[`addedDate`](/documentation/iTunesLibrary/ITLibMediaItem/addedDate)

The date and time that the user added the media item to the iTunes library.

[`modifiedDate`](/documentation/iTunesLibrary/ITLibMediaItem/modifiedDate)

The date and time that iTunes last modified the media item.

[`bitrate`](/documentation/iTunesLibrary/ITLibMediaItem/bitrate)

The bitrate of the media item in kbit/s.

[`sampleRate`](/documentation/iTunesLibrary/ITLibMediaItem/sampleRate)

The sample rate of the media item in samples-per-second.

[`beatsPerMinute`](/documentation/iTunesLibrary/ITLibMediaItem/beatsPerMinute)

The beats-per-minute (BPM) of the media item.

[`playCount`](/documentation/iTunesLibrary/ITLibMediaItem/playCount)

The number of times the user has played the media item.

[`lastPlayedDate`](/documentation/iTunesLibrary/ITLibMediaItem/lastPlayedDate)

The date and time the user last played the media item, or `nil` if the user hasn’t played it.

[`location`](/documentation/iTunesLibrary/ITLibMediaItem/location)

The location of the media item on disk.

[`locationType`](/documentation/iTunesLibrary/ITLibMediaItem/locationType)

The type of the media item with respect to its location.

[`hasArtworkAvailable`](/documentation/iTunesLibrary/ITLibMediaItem/hasArtworkAvailable)

A Boolean value that indicates whether the media item has artwork.

[`artwork`](/documentation/iTunesLibrary/ITLibMediaItem/artwork)

The artwork of the media item.

[`comments`](/documentation/iTunesLibrary/ITLibMediaItem/comments)

Any comments that iTunes associates with the media item.

[`isPurchased`](/documentation/iTunesLibrary/ITLibMediaItem/isPurchased)

A Boolean value that indicates whether the user purchased the media item from the iTunes Store.

[`isDRMProtected`](/documentation/iTunesLibrary/ITLibMediaItem/isDRMProtected)

A Boolean value that indicates whether the media item has digital rights management (DRM) protection.

[`isVideo`](/documentation/iTunesLibrary/ITLibMediaItem/isVideo)

A Boolean value that indicates whether this media item is a video, such as a TV show, video podcast, or movie.

[`videoInfo`](/documentation/iTunesLibrary/ITLibMediaItem/videoInfo)

Video information (such as width and height) about the media item, if it’s a video.

[`releaseDate`](/documentation/iTunesLibrary/ITLibMediaItem/releaseDate)

The release date of the media item.

[`year`](/documentation/iTunesLibrary/ITLibMediaItem/year)

The release year of the media item.

[`skipCount`](/documentation/iTunesLibrary/ITLibMediaItem/skipCount)

The number of times that the user skipped the media item.

[`skipDate`](/documentation/iTunesLibrary/ITLibMediaItem/skipDate)

The date and time that the user last skipped the media item.

[`voiceOverLanguage`](/documentation/iTunesLibrary/ITLibMediaItem/voiceOverLanguage)

The voice-over language of the media item.

[`volumeAdjustment`](/documentation/iTunesLibrary/ITLibMediaItem/volumeAdjustment)

The volume adjustment for the media item, if any.

[`volumeNormalizationEnergy`](/documentation/iTunesLibrary/ITLibMediaItem/volumeNormalizationEnergy)

The volume normalization energy that iTunes applies to the media item to bring the average or peak amplitude to a target level.

[`isUserDisabled`](/documentation/iTunesLibrary/ITLibMediaItem/isUserDisabled)

A Boolean value that indicates whether the user disabled the media item.

[`grouping`](/documentation/iTunesLibrary/ITLibMediaItem/grouping)

The grouping of the media item that the user specifies or that iTunes specifies in the file’s metadata.

[`fileSize`](/documentation/iTunesLibrary/ITLibMediaItem/fileSize)

The size in bytes of this media item on disk.

[`isCloud`](/documentation/iTunesLibrary/ITLibMediaItem/isCloud)

A Boolean value that indicates whether this media item is an iTunes Match or an iTunes in the Cloud item.

[`playStatus`](/documentation/iTunesLibrary/ITLibMediaItem/playStatus)

The play status for the media.

[`ITLibMediaItemMediaKind`](/documentation/iTunesLibrary/ITLibMediaItemMediaKind)

These constants specify the possible media kinds of a media item.

[`ITLibMediaItemLocationType`](/documentation/iTunesLibrary/ITLibMediaItemLocationType)

These constants specify the location type of a media item.

[`ITLibMediaItemLyricsContentRating`](/documentation/iTunesLibrary/ITLibMediaItemLyricsContentRating)

These constants specify the possible ratings of media item lyrics.

[`ITLibMediaItemPlayStatus`](/documentation/iTunesLibrary/ITLibMediaItemPlayStatus)

These constants specify the play status of the media item.

### Media Item Properties

[`ITLibMediaEntityPropertyPersistentID`](/documentation/iTunesLibrary/ITLibMediaEntityPropertyPersistentID)

The unique identifier of the media entity.

[`ITLibMediaItemPropertyAddedDate`](/documentation/iTunesLibrary/ITLibMediaItemPropertyAddedDate)

The date and time the user added the media item to the iTunes library.

[`ITLibMediaItemPropertyAlbumArtist`](/documentation/iTunesLibrary/ITLibMediaItemPropertyAlbumArtist)

The name of the artist that iTunes associates with the media item’s album.

[`ITLibMediaItemPropertyAlbumDiscCount`](/documentation/iTunesLibrary/ITLibMediaItemPropertyAlbumDiscCount)

The number of discs in the media item’s album.

[`ITLibMediaItemPropertyAlbumDiscNumber`](/documentation/iTunesLibrary/ITLibMediaItemPropertyAlbumDiscNumber)

The disc number in the media item’s album.

[`ITLibMediaItemPropertyAlbumIsCompilation`](/documentation/iTunesLibrary/ITLibMediaItemPropertyAlbumIsCompilation)

This property indicates whether the album of the media item is a compilation.

[`ITLibMediaItemPropertyAlbumIsGapless`](/documentation/iTunesLibrary/ITLibMediaItemPropertyAlbumIsGapless)

This property indicates whether the media item’s album is gapless.

[`ITLibMediaItemPropertyAlbumRating`](/documentation/iTunesLibrary/ITLibMediaItemPropertyAlbumRating)

The rating of the media item’s album.

[`ITLibMediaItemPropertyAlbumRatingComputed`](/documentation/iTunesLibrary/ITLibMediaItemPropertyAlbumRatingComputed)

This property indicates whether iTunes computes the rating of the media item’s album from the ratings of individual tracks in the album.

[`ITLibMediaItemPropertyAlbumTitle`](/documentation/iTunesLibrary/ITLibMediaItemPropertyAlbumTitle)

The title of the media item’s album.

[`ITLibMediaItemPropertyAlbumTrackCount`](/documentation/iTunesLibrary/ITLibMediaItemPropertyAlbumTrackCount)

The track count of the media item’s album.

[`ITLibMediaItemPropertyArtistName`](/documentation/iTunesLibrary/ITLibMediaItemPropertyArtistName)

The name of the artist that iTunes associates with the media item.

[`ITLibMediaItemPropertyArtwork`](/documentation/iTunesLibrary/ITLibMediaItemPropertyArtwork)

The artwork for the media item.

[`ITLibMediaItemPropertyBeatsPerMinute`](/documentation/iTunesLibrary/ITLibMediaItemPropertyBeatsPerMinute)

The beats-per-minute (BPM) of the media item.

[`ITLibMediaItemPropertyBitRate`](/documentation/iTunesLibrary/ITLibMediaItemPropertyBitRate)

The bitrate of the media item in kbit/s.

[`ITLibMediaItemPropertyCategory`](/documentation/iTunesLibrary/ITLibMediaItemPropertyCategory)

The podcast category of the media item, if the media item is a podcast.

[`ITLibMediaItemPropertyComments`](/documentation/iTunesLibrary/ITLibMediaItemPropertyComments)

Any comments that iTunes associates with the media item.

[`ITLibMediaItemPropertyComposer`](/documentation/iTunesLibrary/ITLibMediaItemPropertyComposer)

The name of the composer that iTunes associates with the media item.

[`ITLibMediaItemPropertyContentRating`](/documentation/iTunesLibrary/ITLibMediaItemPropertyContentRating)

The extended content rating of the media item.

[`ITLibMediaItemPropertyDescription`](/documentation/iTunesLibrary/ITLibMediaItemPropertyDescription)

A podcast description of the media item, if the media item is a podcast.

[`ITLibMediaItemPropertyFileSize`](/documentation/iTunesLibrary/ITLibMediaItemPropertyFileSize)

The size in bytes of the media item on disk.

[`ITLibMediaItemPropertyGenre`](/documentation/iTunesLibrary/ITLibMediaItemPropertyGenre)

The genre that iTunes associates with the media item.

[`ITLibMediaItemPropertyGrouping`](/documentation/iTunesLibrary/ITLibMediaItemPropertyGrouping)

The grouping of the media item.

[`ITLibMediaItemPropertyHasArtwork`](/documentation/iTunesLibrary/ITLibMediaItemPropertyHasArtwork)

This property indicates whether the media item has artwork.

[`ITLibMediaItemPropertyIsDRMProtected`](/documentation/iTunesLibrary/ITLibMediaItemPropertyIsDRMProtected)

This property indicates whether the media item has digital rights management (DRM) protection.

[`ITLibMediaItemPropertyIsPurchased`](/documentation/iTunesLibrary/ITLibMediaItemPropertyIsPurchased)

This property indicates whether the media item is a purchased media item.

[`ITLibMediaItemPropertyIsUserDisabled`](/documentation/iTunesLibrary/ITLibMediaItemPropertyIsUserDisabled)

This property indicates whether the user disabled the media item.

[`ITLibMediaItemPropertyIsVideo`](/documentation/iTunesLibrary/ITLibMediaItemPropertyIsVideo)

This property indicates whether the media item is a video media item, such as a video podcast or movie.

[`ITLibMediaItemPropertyKind`](/documentation/iTunesLibrary/ITLibMediaItemPropertyKind)

The kind of media item file, such as an MPEG audio file.

[`ITLibMediaItemPropertyLastPlayDate`](/documentation/iTunesLibrary/ITLibMediaItemPropertyLastPlayDate)

The date and time the user last played the media item in iTunes, or `nil` if the user hasn’t played the media item.

[`ITLibMediaItemPropertyLocation`](/documentation/iTunesLibrary/ITLibMediaItemPropertyLocation)

The location of the media item on disk.

[`ITLibMediaItemPropertyLocationType`](/documentation/iTunesLibrary/ITLibMediaItemPropertyLocationType)

The type of the media item with respect to its location.

[`ITLibMediaItemPropertyLyricsContentRating`](/documentation/iTunesLibrary/ITLibMediaItemPropertyLyricsContentRating)

The content rating of the media item’s lyrics.

[`ITLibMediaItemPropertyMediaKind`](/documentation/iTunesLibrary/ITLibMediaItemPropertyMediaKind)

The media kind of the media item.

[`ITLibMediaItemPropertyModifiedDate`](/documentation/iTunesLibrary/ITLibMediaItemPropertyModifiedDate)

The date and time that iTunes last modified the media item.

[`ITLibMediaItemPropertyMovementCount`](/documentation/iTunesLibrary/ITLibMediaItemPropertyMovementCount)

[`ITLibMediaItemPropertyMovementName`](/documentation/iTunesLibrary/ITLibMediaItemPropertyMovementName)

[`ITLibMediaItemPropertyMovementNumber`](/documentation/iTunesLibrary/ITLibMediaItemPropertyMovementNumber)

[`ITLibMediaItemPropertyPlayCount`](/documentation/iTunesLibrary/ITLibMediaItemPropertyPlayCount)

The number of times the user has played the media item in iTunes.

[`ITLibMediaItemPropertyPlayStatus`](/documentation/iTunesLibrary/ITLibMediaItemPropertyPlayStatus)

The play status of the media item.

[`ITLibMediaItemPropertyRating`](/documentation/iTunesLibrary/ITLibMediaItemPropertyRating)

The rating of the media item.

[`ITLibMediaItemPropertyRatingComputed`](/documentation/iTunesLibrary/ITLibMediaItemPropertyRatingComputed)

This property indicates whether iTunes computes the media item’s rating.

[`ITLibMediaItemPropertyReleaseDate`](/documentation/iTunesLibrary/ITLibMediaItemPropertyReleaseDate)

The release date of the media item.

[`ITLibMediaItemPropertySampleRate`](/documentation/iTunesLibrary/ITLibMediaItemPropertySampleRate)

The sample rate of the media item in samples-per-second.

[`ITLibMediaItemPropertySize`](/documentation/iTunesLibrary/ITLibMediaItemPropertySize)

The size in bytes of the media item on disk.

[`ITLibMediaItemPropertySkipDate`](/documentation/iTunesLibrary/ITLibMediaItemPropertySkipDate)

The date and time that the user last skipped the media item.

[`ITLibMediaItemPropertySortAlbumArtist`](/documentation/iTunesLibrary/ITLibMediaItemPropertySortAlbumArtist)

The name of the artist that iTunes associates with the media item’s album, for use when sorting.

[`ITLibMediaItemPropertySortAlbumTitle`](/documentation/iTunesLibrary/ITLibMediaItemPropertySortAlbumTitle)

The title of the media item’s album, for use when sorting.

[`ITLibMediaItemPropertySortArtistName`](/documentation/iTunesLibrary/ITLibMediaItemPropertySortArtistName)

The name of the media item’s artist, for use when sorting.

[`ITLibMediaItemPropertySortComposer`](/documentation/iTunesLibrary/ITLibMediaItemPropertySortComposer)

The name of the composer that iTunes associates with the media item, for use when sorting.

[`ITLibMediaItemPropertySortTitle`](/documentation/iTunesLibrary/ITLibMediaItemPropertySortTitle)

The title of the media item to use when sorting.

[`ITLibMediaItemPropertyStartTime`](/documentation/iTunesLibrary/ITLibMediaItemPropertyStartTime)

If nonzero, the actual time that playback for the media item starts instead of 0:00 (in milliseconds).

[`ITLibMediaItemPropertyStopTime`](/documentation/iTunesLibrary/ITLibMediaItemPropertyStopTime)

If nonzero, the actual time that playback for the media item stops versus the total time (in milliseconds).

[`ITLibMediaItemPropertyTitle`](/documentation/iTunesLibrary/ITLibMediaItemPropertyTitle)

The title of the media item.

[`ITLibMediaItemPropertyTotalTime`](/documentation/iTunesLibrary/ITLibMediaItemPropertyTotalTime)

The length of the media item in milliseconds.

[`ITLibMediaItemPropertyTrackNumber`](/documentation/iTunesLibrary/ITLibMediaItemPropertyTrackNumber)

The numerical position of the media item within its album.

[`ITLibMediaItemPropertyUserSkipCount`](/documentation/iTunesLibrary/ITLibMediaItemPropertyUserSkipCount)

The number of times that the user skipped the media item.

[`ITLibMediaItemPropertyVideoEpisode`](/documentation/iTunesLibrary/ITLibMediaItemPropertyVideoEpisode)

The name of the episode, if the media item is an episode of a TV series.

[`ITLibMediaItemPropertyVideoEpisodeOrder`](/documentation/iTunesLibrary/ITLibMediaItemPropertyVideoEpisodeOrder)

The order of the episode, if the media item is an episode of a TV series.

[`ITLibMediaItemPropertyVideoHeight`](/documentation/iTunesLibrary/ITLibMediaItemPropertyVideoHeight)

The height in pixels, if the media item is a video.

[`ITLibMediaItemPropertyVideoIsHD`](/documentation/iTunesLibrary/ITLibMediaItemPropertyVideoIsHD)

This property indicates whether a video media item is high-definition.

[`ITLibMediaItemPropertyVideoSeason`](/documentation/iTunesLibrary/ITLibMediaItemPropertyVideoSeason)

The corresponding TV season, if the media item is an episode of a TV series.

[`ITLibMediaItemPropertyVideoSeries`](/documentation/iTunesLibrary/ITLibMediaItemPropertyVideoSeries)

The name of the corresponding TV series, if the media item is an episode in a TV series.

[`ITLibMediaItemPropertyVideoSortSeries`](/documentation/iTunesLibrary/ITLibMediaItemPropertyVideoSortSeries)

The sorting name of the corresponding TV series, if the media item is an episode in a TV series.

[`ITLibMediaItemPropertyVideoWidth`](/documentation/iTunesLibrary/ITLibMediaItemPropertyVideoWidth)

The width in pixels, if the media item is a video.

[`ITLibMediaItemPropertyVoiceOverLanguage`](/documentation/iTunesLibrary/ITLibMediaItemPropertyVoiceOverLanguage)

The voice-over language of the media item.

[`ITLibMediaItemPropertyVolumeAdjustment`](/documentation/iTunesLibrary/ITLibMediaItemPropertyVolumeAdjustment)

The volume adjustment for the media item, if any.

[`ITLibMediaItemPropertyVolumeNormalizationEnergy`](/documentation/iTunesLibrary/ITLibMediaItemPropertyVolumeNormalizationEnergy)

The volume normalization energy that iTunes applies to the media item to bring the average or peak amplitude to a target level.

[`ITLibMediaItemPropertyWork`](/documentation/iTunesLibrary/ITLibMediaItemPropertyWork)

[`ITLibMediaItemPropertyYear`](/documentation/iTunesLibrary/ITLibMediaItemPropertyYear)

The release year of the media item.

### Deprecated

[`fileType`](/documentation/iTunesLibrary/ITLibMediaItem/fileType)

The file type of the media item.

[`size`](/documentation/iTunesLibrary/ITLibMediaItem/size)

The size in bytes of the media item on disk.

[`ITLibMediaItemPropertyFileType`](/documentation/iTunesLibrary/ITLibMediaItemPropertyFileType)

The file type of the media item.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)