---
title: ITLibrary
framework: ituneslibrary
role: symbol
role_heading: Class
path: ituneslibrary/itlibrary
---

# ITLibrary

This class serves as the entry point to the iTunesLibrary framework.

## Declaration

```swift
class ITLibrary
```

## Overview

Overview Use the ITLibrary properties and methods to retrieve media items (tracks) and playlists from the user’s iTunes library. ITLibrary also provides methods for extracting artwork from a media file that may or may not be in the iTunes library. Sandboxed and nonsandboxed apps can also use iTunes’ ability to extract artwork. important: A person needs to grant your app permission before it can access their iTunes library. Add the NSAppleMusicUsageDescription key to your app’s Info.plist file, and include a description of how you intend to use their library. If this key isn’t present, the system terminates your app when it tries to access the library.

## Topics

### Essentials

- [init(apiVersion:)](ituneslibrary/itlibrary/init(apiversion:)-71e74.md)
- [init(apiVersion:options:)](ituneslibrary/itlibrary/init(apiversion:options:)-9eorg.md)
- [ITLibInitOptions](ituneslibrary/itlibinitoptions.md)

### Getting iTunes Library Info

- [allMediaItems](ituneslibrary/itlibrary/allmediaitems.md)
- [allPlaylists](ituneslibrary/itlibrary/allplaylists.md)
- [apiMajorVersion](ituneslibrary/itlibrary/apimajorversion.md)
- [apiMinorVersion](ituneslibrary/itlibrary/apiminorversion.md)
- [applicationVersion](ituneslibrary/itlibrary/applicationversion.md)
- [mediaFolderLocation](ituneslibrary/itlibrary/mediafolderlocation.md)
- [shouldShowContentRating](ituneslibrary/itlibrary/shouldshowcontentrating.md)

### Loading and Unloading Data

- [reloadData()](ituneslibrary/itlibrary/reloaddata().md)
- [unloadData()](ituneslibrary/itlibrary/unloaddata().md)

### Accessing Artwork

- [artwork(forMediaFile:)](ituneslibrary/itlibrary/artwork(formediafile:).md)

### Deprecated

- [features](ituneslibrary/itlibrary/features.md)
- [ITLibExportFeature](ituneslibrary/itlibexportfeature.md)
- [musicFolderLocation](ituneslibrary/itlibrary/musicfolderlocation.md)

### Initializers

- [init(APIVersion:)](ituneslibrary/itlibrary/init(apiversion:)-1ryrd.md)
- [init(APIVersion:)](ituneslibrary/itlibrary/init(apiversion:)-2f5om.md)
- [init(APIVersion:options:)](ituneslibrary/itlibrary/init(apiversion:options:)-3a3ng.md)
- [init(APIVersion:options:)](ituneslibrary/itlibrary/init(apiversion:options:)-d24u.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)