indesignlatam/react-native-itunes

iTunes module for React Native

iTunes React Native

Access your iTunes library (iOS only)

Example project

Installation

In the command line, first you need to install react-native-itunes:

npm install react-native-itunes --save

Automatically link

With React Native 0.27+

react-native link react-native-itunes

With older versions of React Native

You need rnpm (npm install -g rnpm)

rnpm link react-native-itunes

Manually link

In XCode, in the project navigator, right click Libraries ➜ Add Files to [your project's name] Go to node_modules ➜ react-native-itunes and add the .xcodeproj file

In XCode, in the project navigator, select your project. Add the lib*.a from the react-native-itunes project to your project's Build Phases ➜ Link Binary With Libraries Click .xcodeproj file you added before in the project navigator and go the Build Settings tab. Make sure 'All' is toggled on (instead of 'Basic'). Look for Header Search Paths and make sure it contains both $(SRCROOT)/../react-native/React and $(SRCROOT)/../../React - mark both as recursive.

Run your project (Cmd+R)

Examples

Note: it works on the device (it even shows on the cloud Apple Music saved songs)

Get all tracks

import iTunes from 'react-native-itunes';

iTunes.getTracks().then((tracks) => {
  console.log(tracks);
});

Get all playlists

Beware, check other examples for better performances

import iTunes from 'react-native-itunes';

iTunes.getPlaylists().then(playlists => {
  console.log(playlists);
});

Play searched track

import iTunes from 'react-native-itunes';

iTunes.getTracks({
  query: {
    title: 'digital',
    albumArtist: 'daft',
  },
}).then((tracks) => {
  iTunes.playTrack(tracks[0])
    .then(res => {
      console.log('is playing');
    })
    .catch(err => {
      alert('err');
    });
});

More examples

Note: it works on the device (it even shows on the cloud Apple Music saved songs)

API

getPlaylists({ fields = {}, query = {} })

Returns [PlaylistItem]

• fields: Array
  • name
  • tracks
  • playCount
• query: Object
  • name

getTracks({ fields = {}, query = {} })

Returns [TrackItem]

• fields: Array https://developer.apple.com/library/ios/documentation/MediaPlayer/Reference/MPMediaItem_ClassReference/
• query: Object
  • title
  • albumArtist
  • albumTitle
  • artist
  • genre

playTrack(Track)

pause()

PlaylistItem

• name
• playCount
• tracks: [TrackItem]

TrackItem

• albumArtist
• albumTitle
• duration (in seconds)
• genre
• playCount
• title

Links

• The Apple documentation on the MPMediaItem used: https://developer.apple.com/library/ios/documentation/MediaPlayer/Reference/MPMediaItem_ClassReference/

  • If you need more info, check out those properties list and do not hesitate doing a pull request (PR) with your addition

Changelog

0.4.0

• Get playlists

0.3.1

• Access artwork as base64

0.3.0

• Play track from TrackItem.title & TrackItem.albumTitle
• Play/Pause

0.2.0

• Query tracks
• Filter tracks
• Get specific fields

0.1.0

• Search all tracks

Roadmap

• Add tests
• Refactor to have one function dealing with queries
• Refactor #getTracks to always return TrackItem.title & TrackItem.albumTitle
• Change all code and examples to ES6
• Get playlist

Player

• Play from searched items
• play()/pause()

getTracks(params)

• Object [params.query={}]
• Object [params.fields={}]

Known bugs

Unplayable tracks

For some reasons some tracks are not playing while they can be searched. If you have a clue why, please share.

Playlist tracks

Some playlist tracks cannot be played. Maybe those which are not cached. Might be related to first bug, but the first bug does not through a warning Investigating to flag them as unplayable before getting an error...

Thanks to

Malone Hedges for the getPlaylists(). I discovered that some Apple Music songs are only available via playlists