https://github.com/rangerrick/plex-itunes-import

A tool for importing iTunes playlists into Plex.
https://github.com/rangerrick/plex-itunes-import

Last synced: about 1 year ago
JSON representation

A tool for importing iTunes playlists into Plex.

• Host: GitHub
• URL: https://github.com/rangerrick/plex-itunes-import
• Owner: RangerRick
• License: mit
• Created: 2017-01-04T17:50:08.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2018-03-22T20:51:14.000Z (about 8 years ago)
• Last Synced: 2025-03-13T14:23:23.098Z (over 1 year ago)
• Language: JavaScript
• Size: 39.1 KB
• Stars: 3
• Watchers: 3
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
iTunes Playlist Importer for Plex

=================================

This project is a tool for importing an `iTunes Playlist.xml` file into Plex.  It assumes that the iTunes playlist and Plex are both using the same files, ie, they are both referencing music in the same directory or network share (most of the matching is based on the path/filenames matching).

Configuring the Importer

------------------------

Copy the `example.yaml` file to `config.yaml` and edit it to match your iTunes and Plex settings.



  
hostname

  
The hostname or IP address of your Plex server.


  
port

  
The port that Plex is listening on.  (Optional)


  
username

  
Your Plex username.


  
password

  
Your Plex password.


  
managedUser

  
If you are using PlexHome users, set the name and pin for the PlexHome user to operate as.


  
itunesxml

  
The complete path to your iTunes Library.xml file.


  
stripPrefixes

  
A list of prefixes to strip off of the beginning of file names when trying to determine song matches.


  
stripNames

  
A list of regular expressions that are applied (in order, top to bottom) to album and song names when searching Plex for matches.



Running the Importer

--------------------

Once you have checked out/downloaded the project, install the dependencies:

`npm install`

Then, you can run the importer with:

`npm run import -- [--verbose] [--debug] [--config path/to/config.yaml]`

TODO

----

* handle iTunes playlist changes (adding/removing songs)

* handle deleting an iTunes playlist

* be more efficient in requests (make a real cache that can track iTunes songs and Plex songs and avoid unnecessary queries)

* GUI?